萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

滾輪事件處理指南:wheel 事件標準化、deltaMode 歸一化、防抖節流、被動監聽器與橫向滾動

滾輪交互是縮放畫布、橫向輪播、無限滾動的核心。本文詳細講解標準 wheel 事件對象、deltaMode 單位歸一化、跨瀏覽器方向判斷、passive: true 效能優化、防抖/節流控制頻率、橫向滾動實現。

wheel 事件對象核心屬性

屬性含義單位
deltaX水平滾動量像素/行/頁(視 deltaMode)
deltaY垂直滾動量像素/行/頁
deltaZZ 軸滾動(罕用)同上
deltaMode單位模式:0=像素、1=行、2=頁枚舉

歸一化為像素

function normalizeWheel(e) {
  const LINE_HEIGHT = 16; // 近似行高
  const PAGE_HEIGHT = 400; // 近似頁高
  let { deltaX, deltaY, deltaMode } = e;
  if (deltaMode === 1) { deltaX *= LINE_HEIGHT; deltaY *= LINE_HEIGHT; }
  else if (deltaMode === 2) { deltaX *= PAGE_HEIGHT; deltaY *= PAGE_HEIGHT; }
  return { deltaX, deltaY };
}

// 使用
element.addEventListener('wheel', e => {
  const { deltaY } = normalizeWheel(e);
  if (deltaY > 0) console.log('向下滾動');
  else console.log('向上滾動');
}, { passive: true });

方向判斷與縮放

canvas.addEventListener('wheel', e => {
  e.preventDefault(); // 防止頁面滾動
  const { deltaY } = normalizeWheel(e);
  if (e.ctrlKey || e.metaKey) {
    // 縮放
    scale *= deltaY > 0 ? 0.9 : 1.1;
    render();
  } else if (e.shiftKey) {
    // 橫向滾動
    scrollX += deltaY;
  } else {
    // 縱向滾動
    scrollY += deltaY;
  }
}, { passive: false }); // 需要 preventDefault,不可 passive

被動監聽器

// 預設 passive: true,瀏覽器可異步滾動,不阻塞主執行緒
el.addEventListener('wheel', handler, { passive: true });

// 需要 preventDefault(如畫布縮放、橫向滾動攔截)時
el.addEventListener('wheel', handler, { passive: false });

防抖/節流控制高頻觸發

// 節流:固定間隔執行
const throttled = throttle(handleWheel, 16); // ~60fps
el.addEventListener('wheel', throttled, { passive: true });

// 防抖:停止滾動後執行(如滾動加載完成回調)
const debounced = debounce(onScrollEnd, 150);
el.addEventListener('wheel', debounced, { passive: true });

避坑指南

  • 舊事件 mousewheel、DOMMouseScroll 已棄用,僅做極舊瀏覽器兼容。
  • deltaY > 0 通常表示**向下/遠離用戶**,但 Mac 觸控板自然滾動方向可在系統設置反轉,邏輯勿硬編碼「正=下」。
  • 觸控板連續滾動產生大量微小 delta,需節流或累積閾值後再響應。
copyright © 萬盛學電腦網 all rights reserved