光标跟随效果必须用 javascript 驱动,css 仅通过变量和伪元素实现定位;需监听 mousemove/touchmove,用 raf 优化性能,注意滚动、缩放、多端兼容及交互不干扰。

光标跟随效果必须用 JavaScript 驱动
纯 CSS 无法读取鼠标坐标,cursor 属性只支持有限的内置样式或图片,不支持实时位置计算。所谓“CSS 实现动态光标跟随”,本质是用 JS 获取 clientX/clientY,再通过 CSS 变量把坐标透传给伪元素或装饰层。
常见错误现象::hover + transform: translate() 看起来像跟随,实则是静态偏移;或者误以为 cursor: url(...) 能动态更新,但该 URL 是硬编码,无法响应鼠标移动。
- 必须监听
mousemove事件,持续更新自定义 CSS 变量(如--mouse-x、--mouse-y) - 目标元素需设
position: relative或position: fixed,否则伪元素定位会错乱 - 避免在
body上直接监听 —— 滚动时clientX/Y仍有效,但若用pageX/Y未处理滚动偏移,光标会漂移
用 ::before 或 ::after 渲染跟随光标
这是最轻量、兼容性最好的方案:不新增 DOM 节点,靠伪元素 + CSS 变量定位。关键在于用 calc() 把变量转为像素值,并确保单位正确。
使用场景:替代原生光标、做悬停高亮圈、实现“磁吸式”指针反馈。
- 伪元素需设
content: ""、position: fixed(或absolute,取决于容器定位) - CSS 变量值默认无单位,必须显式写成
calc(var(--mouse-x) * 1px),否则计算无效 - 为防抖动,建议加
pointer-events: none,避免伪元素拦截鼠标事件 - 示例关键代码:
body::before { content: ""; position: fixed; width: 12px; height: 12px; background: #007bff; border-radius: 50%; transform: translate(calc(var(--mouse-x, 0) * 1px), calc(var(--mouse-y, 0) * 1px)); pointer-events: none; z-index: 9999; }
requestAnimationFrame 不是必须,但能避免卡顿
直接在 mousemove 里更新 CSS 变量,高频触发下可能造成掉帧,尤其在低性能设备上。不是所有项目都需要优化,但一旦出现明显延迟或跳变,就得介入。
性能影响:每秒触发 60+ 次 mousemove 是常态,而 requestAnimationFrame 会将其收敛到屏幕刷新率(通常 60fps),减少冗余计算。
- 不要用
setTimeout或debounce—— 会导致光标明显滞后 - 推荐模式:用
let pending = false+rAF批量更新,而非每次事件都写变量 - 兼容性无问题:
requestAnimationFrame在现代浏览器中稳定支持,IE10+ 也可用
移动端触摸事件要单独处理
PC 端的 mousemove 在手机上完全不触发,必须监听 touchmove 并取 touches[0] 坐标。而且触摸屏存在多点触控,只跟踪第一个手指即可。
容易踩的坑:touchmove 默认可滚动页面,不加 preventDefault() 会导致光标跳动甚至页面意外滑动;另外,触摸坐标是相对于视口的,和 clientX/Y 一致,无需额外转换。
- 监听时需同时绑定
touchstart和touchmove,确保首次触摸就生效 - 更新变量前加
event.preventDefault()(仅对touchmove) - 注意
touchend后清空坐标,否则光标会卡在最后位置 - 不要试图用
pointer events一统 PC/移动 —— Safari 对pointermove的支持仍有小概率失灵
光标跟随真正难的不是定位,而是跨设备一致性、滚动与缩放下的坐标对齐、以及不干扰用户正常交互——这些细节往往在第一次上线后才暴露。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











