0

0

VueUse useMouse() 响应式失效的根源与正确 CDN 引入方案

霞舞

霞舞

发布时间:2026-01-14 14:59:02

|

232人浏览过

|

来源于php中文网

原创

VueUse useMouse() 响应式失效的根源与正确 CDN 引入方案

使用 vueuse 的 `usemouse()` 时,控制台能实时输出鼠标坐标但模板中始终显示 `0`,根本原因在于通过 jsdelivr 的 `+esm` 路径引入会破坏内部依赖(尤其是 `@vueuse/shared`),导致响应式对象未被正确识别,需显式声明所有依赖模块。

在 Vue 3 的组合式 API 中,@vueuse/core 的 useMouse() 返回的是基于 ref() 的响应式对象(即 { x: Ref, y: Ref })。理论上只要将 x 和 y 正确暴露给模板,就能实现自动更新。但你遇到的「模板中始终为 0,而 console.log(x.value, y.value) 却能正常变化」这一矛盾现象,并非 Vue 响应式机制失效,而是 ESM 构建产物加载失败导致的“伪响应式”

根本问题出在 CDN 引入方式:
https://cdn.jsdelivr.net/npm/@vueuse/core@11.2.0/+esm 这类 +esm 路径是 jsDelivr 提供的自动转换服务,它尝试将 CommonJS 包转为 ESM,但 @vueuse/core 内部强依赖 @vueuse/shared(提供 tryOnMounted、reactify 等基础工具),而 +esm 模式无法自动解析并加载该 peer 依赖。结果是 useMouse() 函数虽可调用,但其内部用于同步 DOM 事件与响应式状态的关键逻辑(如 reactive 包装、watch 注册)因缺失 shared 工具而降级或静默失败——返回的 x/y 实际是未被 Vue 正确追踪的普通 Ref,故模板无法触发更新。

✅ 正确解法:显式、完整地声明所有必需的 ESM 入口文件,绕过 +esm 的不可靠自动转换:




mouse : {{ x }} | {{ y }}

⚠️ 关键注意事项:

萝卜简历
萝卜简历

免费在线AI简历制作工具,帮助求职者轻松完成简历制作。

下载

立即学习前端免费学习笔记(深入)”;

  • vue-demi 是必需的 polyfill,确保 @vueuse/* 在不同 Vue 版本间兼容;
  • 所有 @vueuse/* 子包必须使用 .min.mjs 后缀的预构建 ESM 文件(而非源码 .ts 或未处理的 .js),这是官方推荐的 CDN 使用方式;
  • 不要混用 +esm 与手动指定路径——二者机制冲突;
  • 若项目已使用 Vite/Webpack,强烈建议改用 npm install @vueuse/core 本地安装,避免 CDN 不确定性。

总结:useMouse() 本身完全响应式,问题永远不在 Hook,而在环境配置。确保依赖图完整、ESM 入口明确,即可让 x/y 在模板中实时响应鼠标移动——这才是 VueUse “开箱即用”体验的真正前提。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

244

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

254

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

5270

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

477

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

206

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

217

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

218

2023.09.21

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 6.4万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 1.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号