萬盛學電腦網

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

JavaScript 鼠標滾輪事件跨瀏覽器綁定與滾動方向判斷

事件標準化

瀏覽器事件名屬性方向值
IE/Edge/Chrome/Safari/Operamousewheel / wheelwheelDelta (+120 向上, -120 向下)正=上,負=下
Firefox (舊)DOMMouseScrolldetail (-3 向上, +3 向下)負=上,正=下
現代標準 (所有)wheeldeltaY (正=下,負=上)負=上,正=下

統一封裝:滾輪指令類


class WheelHandler {
  /**
   * @param {HTMLElement} target - 監聽目標,默認 window
   * @param {Function} onWheel - 回調 (delta, event) delta>0 向下, <0 向上
   * @param {Object} options
   */
  constructor(target = window, onWheel, options = {}) {
    this.target = target;
    this.onWheel = onWheel;
    this.options = Object.assign({
      passive: false,     // 是否 passive 模式(不阻止默認)
      normalize: true,    // 歸一化 delta 為 ±1
      preventDefault: true // 阻止頁面滾動
    }, options);
    
    this._bind();
  }
  
  _bind() {
    // 現代統一事件
    this.target.addEventListener('wheel', this._handleWheel.bind(this), { 
      passive: this.options.passive 
    });
    
    // Firefox 兼容(舊版)
    if ('onwheel' in document === false) {
      this.target.addEventListener('DOMMouseScroll', this._handleWheel.bind(this), { 
        passive: this.options.passive 
      });
    }
  }
  
  _handleWheel(e) {
    let delta = 0;
    
    if (e.deltaY !== undefined) { // WheelEvent (現代標準)
      delta = e.deltaY;
      // deltaMode: 0=像素, 1=行, 2=頁
      if (e.deltaMode === 1) delta *= 40; // 行高近似
      else if (e.deltaMode === 2) delta *= 400; // 頁高近似
    } else if (e.wheelDelta !== undefined) { // MouseWheelEvent (舊 WebKit/IE)
      delta = -e.wheelDelta; // 統一為:正=下,負=上
    } else if (e.detail !== undefined) { // DOMMouseScroll (Firefox 舊)
      delta = e.detail * 40; // 近似像素
    }
    
    // 歸一化為 ±1
    if (this.options.normalize) {
      delta = delta > 0 ? 1 : -1;
    }
    
    // 阻止默認滾動
    if (this.options.preventDefault) {
      e.preventDefault();
    }
    
    // 觸發回調
    if (this.onWheel) this.onWheel(delta, e);
  }
  
  destroy() {
    this.target.removeEventListener('wheel', this._handleWheel.bind(this));
    this.target.removeEventListener('DOMMouseScroll', this._handleWheel.bind(this));
  }
}

使用示例

1. 圖片輪播切換


const carousel = document.querySelector('.carousel');
let currentIndex = 0;
const items = carousel.querySelectorAll('.item');

new WheelHandler(carousel, (delta) => {
  if (delta > 0) { // 向下滾動 -> 下一張
    currentIndex = (currentIndex + 1) % items.length;
  } else { // 向上滾動 -> 上一張
    currentIndex = (currentIndex - 1 + items.length) % items.length;
  }
  updateCarousel();
}, { preventDefault: true }); // 阻止頁面滾動

2. 縮放控制


const canvas = document.getElementById('canvas');
let scale = 1;

new WheelHandler(canvas, (delta, e) => {
  if (e.ctrlKey || e.metaKey) { // 按住 Ctrl/Command 縮放
    e.preventDefault();
    const factor = delta > 0 ? 0.9 : 1.1; // 向下縮小,向上放大
    scale = Math.max(0.1, Math.min(5, scale * factor));
    canvas.style.transform = `scale(${scale})`;
  }
}, { preventDefault: false, normalize: false }); // 需要精確 delta 值

3. 橫向滾動容器


const hScroll = document.querySelector('.h-scroll');

new WheelHandler(hScroll, (delta, e) => {
  // 垂直滾輪轉為橫向滾動
  hScroll.scrollLeft += delta * 40; // delta 已歸一化 ±1
}, { preventDefault: true });

4. 節流防抖(高頻觸發優化)


function throttle(fn, delay = 16) {
  let last = 0;
  return (...args) => {
    const now = Date.now();
    if (now - last >= delay) {
      last = now;
      fn(...args);
    }
  };
}

new WheelHandler(window, throttle((delta) => {
  // 處理滾動邏輯
  console.log('滾動方向:', delta > 0 ? '下' : '上');
}, 50), { passive: true }); // passive: true 允許瀏覽器優化滾動

Passive Event Listeners 關鍵知識

現代瀏覽器默認將 wheel/touchstart 視為 passive: true,即不能調用 preventDefault()。若需阻止默認滾動,必須顯式聲明 { passive: false }。


// 檢測支持
let supportsPassive = false;
try {
  const opts = Object.defineProperty({}, 'passive', { get() { supportsPassive = true; } });
  window.addEventListener('test', null, opts);
} catch (e) {}

const handler = (e) => { /* ... */ };
window.addEventListener('wheel', handler, supportsPassive ? { passive: false } : false);

鍵盤輔助滾動(無障礙)


document.addEventListener('keydown', (e) => {
  const scrollAmount = 100;
  switch (e.key) {
    case 'ArrowDown': case 'PageDown': 
      window.scrollBy(0, scrollAmount); break;
    case 'ArrowUp': case 'PageUp': 
      window.scrollBy(0, -scrollAmount); break;
    case 'Home': window.scrollTo(0, 0); break;
    case 'End': window.scrollTo(0, document.body.scrollHeight); break;
  }
});

常見坑點

  1. Mac 觸控板: 惯性滾動產生大量微小 delta,需閾值過濾或節流
  2. 高精度滾輪: 部分鼠標 deltaY 為 1/3/5 等非 120 倍數,歸一化邏輯需健壯
  3. 嵌套滾動容器: 事件冒泡導致外層也觸發,用 e.target.closest('.scroll-container') 判斷
  4. 縮放檢測: e.ctrlKey (Win/Linux) / e.metaKey (Mac) 區分縮放與滾動
copyright © 萬盛學電腦網 all rights reserved