悬浮框动态跟随鼠标需JS捕获坐标并注入CSS变量，因纯CSS无法读取event.clientX/Y；须用document.documentElement.style.setProperty()设带单位的--mouse-x/--mouse-y，配合position:fixed与transform:translate()实现高性能定位。
悬浮框定位为什么不能只靠 position: absolute + 固定 top/left？
因为鼠标坐标是实时变化的，纯 CSS 无法读取 event.clientX 或 event.clientY。硬写死 top: 100px; left: 200px 只能定位一次，后续移动就脱节了。必须由 JS 捕获坐标，再交由 CSS 渲染——关键在于「把 JS 的数值，变成 CSS 能用的变量」。
如何用 document.documentElement.style.setProperty() 动态更新 CSS 变量
这是最轻量、无框架依赖的通信方式：JS 把坐标存进 :root 下的自定义属性，CSS 用 var(--mouse-x) 直接读取。注意两点：
-
setProperty必须作用在document.documentElement（即:root），否则子元素无法继承 - 坐标值要带单位（如
"123px"），CSS 变量本身不解析单位，传数字会失效 - 频繁触发时建议加
requestAnimationFrame节流，避免 layout thrashing
document.addEventListener('mousemove', (e) => {
requestAnimationFrame(() => {
document.documentElement.style.setProperty('--mouse-x', `${e.clientX}px`);
document.documentElement.style.setProperty('--mouse-y', `${e.clientY}px`);
});
});
transform: translate() 比 top/left 更适合做跟随偏移
用 top/left 触发重排（reflow），而 transform 只走合成层，性能更好；且默认以元素自身中心为基准，配合 translate(-50%, -50%) 能自然实现「鼠标指针在悬浮框正中心」的效果。
- 悬浮框需设
position: fixed（脱离文档流，不受滚动影响） -
transform: translate(calc(var(--mouse-x) - 50%), calc(var(--mouse-y) - 50%))不行——calc()里不能混用带单位和不带单位的值 - 正确写法是 JS 传入已减去半宽高的像素值，或 CSS 用
translate(var(--mouse-x), var(--mouse-y))+margin-left: -50%; margin-top: -50%拆解
推荐更稳的组合：
立即学习“前端免费学习笔记（深入）”；
:root {
--mouse-x: 0px;
--mouse-y: 0px;
}
.tooltip {
position: fixed;
transform: translate(var(--mouse-x), var(--mouse-y));
margin: -16px 0 0 -16px; /* 假设宽高都是 32px */
}为什么鼠标快速移动时悬浮框会“滞后”或“抖动”？
本质是 JS 更新频率和浏览器渲染节奏不匹配。即使用了 requestAnimationFrame，如果计算逻辑重（比如每次都要查 DOM、算 offset）、或 CSS 有阻塞渲染的属性（如 box-shadow 过重、filter: blur()），都会拖慢帧率。
- 确保悬浮框元素
will-change: transform，提前提示浏览器该元素将动画化 - 避免在
mousemove里调用getBoundingClientRect()或修改 class - 如果悬浮框内容需异步加载（如 tooltip 显示详情），务必用
pointer-events: none临时禁用，防止鼠标移入框体触发新事件，形成循环 - 移动端要注意
touchmove需单独监听，且clientX/Y在部分安卓 WebView 中可能不准，建议 fallback 到touches[0]
真正难调的不是怎么让它动起来，而是动得足够顺、足够准、足够不抢用户焦点——这些细节全藏在事件绑定时机、变量更新粒度和渲染属性选择里。
