如何精准区分用户主动滚动与锚点平滑跳转触发的滚动行为

本文介绍在启用 `scroll-behavior: smooth` 的页面中，如何避免锚点链接触发的平滑滚动误触 scroll 事件，推荐使用 `wheel` 事件替代 `scroll` 事件，并辅以节流控制，实现仅响应真实用户滚动操作。

在现代 Web 开发中，为提升用户体验，常通过 css 设置 html { scroll-behavior: smooth; } 实现原生平滑锚点跳转。但该特性会触发 scroll 事件（即使由 点击引发），导致你无法区分「用户手动滚动」与「程序化/导航式滚动」——这在需监听真实滚动行为的场景（如懒加载、滚动进度条、吸顶导航等）中尤为棘手。

直接监听 scroll 事件并尝试在点击时临时移除监听器（如 removeEventListener）并不可靠：

• 平滑滚动是异步且持续数百毫秒的，你无法准确预判其何时开始/结束；
• 多次快速点击或键盘导航（如 Tab + Enter）易造成监听器状态错乱；
• scroll 事件本身在平滑滚动期间高频触发，加剧误判风险。

✅ 更稳健的解决方案：改用 wheel 事件
wheel 事件仅在用户通过鼠标滚轮、触摸板滚动或键盘（空格/方向键）主动触发滚动时触发，而不会被 scroll-behavior: smooth 的锚点跳转、window.scrollTo() 或 element.scrollIntoView() 等 API 触发。因此，它天然区分了「人为滚动」与「声明式导航滚动」。

以下是优化后的完整实现：

function scrollHandler() {   console.log("user scrolled (wheel or keyboard)"); }  // 节流防止高频触发（200ms 间隔） const throttledScrollHandler = throttle(scrollHandler, 200);  // ✅ 监听 wheel 而非 scroll window.addEventListener("wheel", throttledScrollHandler, { passive: true });  // 可选：同时监听键盘滚动（PageUp/PageDown/ArrowKeys 等） window.addEventListener("keydown", (e) => {   if ([32, 33, 34, 35, 36, 37, 38, 39, 40].includes(e.keyCode)) {     // 空格、PgUp、PgDn、Home、End、方向键 —— 常见滚动键     throttledScrollHandler();   } });  function throttle(callback, delay) {   let timer = null;   return function (...args) {     if (timer) return;     timer = setTimeout(() => {       callback(...args);       timer = null;     }, delay);   }; }

⚠️ 注意事项与补充说明：

• wheel 事件默认为 passive: true（推荐显式声明），避免因 preventDefault() 导致滚动卡顿；
• 若需兼容触屏设备上的“拖拽滚动”（非惯性滚动），注意：ios safari 和部分 android 浏览器中 wheel 在触摸拖拽时可能不触发，此时可结合 touchstart + touchend 时间差判断（但本例中锚点跳转仍不会触发，故 wheel 已满足核心需求）；
• 不要依赖 scroll 事件的 event.detail 或 deltaY 判断来源——它们无法区分触发源；
• 如后续需支持 scroll 事件的其他用途（如监听 position: sticky 元素状态），请确保逻辑解耦，避免混用。

总结：当页面启用 scroll-behavior: smooth 时，放弃对 scroll 事件的“来源过滤”幻想，转向语义更明确的 wheel（+ keydown）事件组合，是轻量、可靠且符合浏览器规范的最佳实践。