You need to enable JavaScript to run this app. Locomotive Scroll横向滚动场景下 Ink自定义光标鼠标位置无法更新
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 15:15:06