Locomotive Scroll横向滚动场景下 Ink自定义光标鼠标位置无法更新
问题根因
- 新增的mousewheel监听里的位置更新逻辑完全失效:回调中读取的
event.clientX/event.clientY是鼠标相对于视口的坐标,当用户不移动物理鼠标、仅通过滚轮触发页面横向滚动时,这两个值全程不会发生变化,赋值给mousePosition的结果和滚动前完全一致,自然看不到任何更新效果。 - 现有光标定位逻辑仅使用了视口坐标系的鼠标位置,没有叠加横向滚动产生的内容层偏移,因此滚动发生时,光标和页面内容的相对位置会持续错位。
可落地的修正方案
完全不需要新增额外的事件监听,直接在原有渲染循环里叠加滚动偏移计算即可,实现逻辑如下:
- 拆分坐标系存储逻辑:mousemove事件回调里仅存储视口坐标系下的原始鼠标位置,避免在事件回调里做坐标转换
- 接入Locomotive Scroll的实时滚动值:通过实例暴露的
scroll.x属性获取当前横向滚动的累计偏移量 - 在每帧渲染计算光标位置时,统一把横向滚动偏移叠加到鼠标视口坐标上,得到页面内容层的绝对光标位置
修正后的核心参考代码
// 初始化Locomotive Scroll实例,注意开启横向方向配置 const scrollInstance = new LocomotiveScroll({ el: document.querySelector('[data-scroll-container]'), smooth: true, direction: 'horizontal' }) // 单独存储视口坐标系下的鼠标原始位置 let viewportMousePosition = { x: 0, y: 0 } // 重写mousemove回调,只做原始值存储 const onMouseMove = (event) => { viewportMousePosition.x = event.clientX viewportMousePosition.y = event.clientY resetIdleTimer() } window.addEventListener('mousemove', onMouseMove) // 移除完全无效的mousewheel监听 // window.addEventListener('mousewheel', onMouseScroll) const positionCursor = (delta) => { // 渲染时实时读取当前横向滚动偏移,计算绝对光标位置 const currentScrollX = scrollInstance.scroll.x let x = viewportMousePosition.x + currentScrollX - width / 2 let y = viewportMousePosition.y - width / 2 // 原有墨水光标的拖尾计算逻辑无需改动 dots.forEach((dot, index, dots) => { let nextDot = dots[index + 1] || dots[0]; dot.x = x; dot.y = y; dot.draw(delta); if (!idle || index <= sineDots) { const dx = (nextDot.x - dot.x) * 0.35; const dy = (nextDot.y - dot.y) * 0.35; x += dx; y += dy; } }); }
优化提示:把偏移计算放到
requestAnimationFrame的渲染循环里,能匹配Locomotive Scroll的平滑滚动帧率,不会出现滚轮触发事件时机和渲染时机不同步导致的光标抖动、滞后问题,比单独监听wheel事件的体验顺滑很多。
内容的提问来源于stack exchange,提问作者Sven Z
相关产品推荐
相关产品推荐

