DIV CSS 佈局教程網

解析 JavaScript 的滑鼠滾輪事件與跨瀏覽器差異
編輯:關於JavaScript     

所有現代瀏覽器都支援滑鼠滾輪,並在滾動時觸發事件。瀏覽器預設會用滾輪來捲動或縮放頁面,但我們可以透過取消該事件的預設行為來阻止。真正的麻煩在於跨瀏覽器的差異——事件名稱、方向判斷的屬性、甚至正負號的慣例都不一致。

三種事件名稱

  • mousewheel:非標準,除 Firefox 外的瀏覽器普遍支援。
  • DOMMouseScroll:Firefox 使用的非標準事件。
  • wheel:DOM3 事件規範草案建議的標準名稱,現代瀏覽器皆已支援。

基本用法

// 標準寫法(IE9+、Chrome、Firefox 現版本皆可)
document.body.onwheel = function (event) {
    event = event || window.event;
    console.dir(event);
};

// 舊寫法:非 Firefox 瀏覽器
document.body.onmousewheel = function (event) {
    event = event || window.event;
    console.dir(event);
};

// 舊寫法:Firefox
document.body.addEventListener("DOMMouseScroll", function (event) {
    console.dir(event);
});

方向判斷的屬性差異

在 Chrome 與 IE 中,向下滾動時 event.wheelDelta 的值為 -120(向上為 +120);Firefox 則用 event.detail,向下滾動為 3(向上為 -3)。兩者的正負號恰好相反,這是實作時最容易出錯的地方。

換算關係是:detail × -40 = wheelDelta。

跨瀏覽器的相容寫法

var isFirefox = (navigator.userAgent.indexOf("Firefox") !== -1);

if (isFirefox) {
    element.addEventListener("DOMMouseScroll", wheelHandler, false);
}
element.onmousewheel = wheelHandler;

function wheelHandler(event) {
    event = event || window.event;
    // wheelDelta 向上為正;detail 向下為正,乘 -1 後統一為「向上為正」
    var delta = event.wheelDelta || -event.detail * 40;
    console.log('delta =', delta);
}

現代寫法:統一用 wheel 事件

今天已經不需要判斷 User-Agent 了。標準的 wheel 事件提供三個屬性,語意清晰且方向一致:

element.addEventListener('wheel', function (e) {
    // deltaY < 0 代表向上(遠離使用者),> 0 代表向下
    console.log('deltaX:', e.deltaX);
    console.log('deltaY:', e.deltaY);
    console.log('deltaZ:', e.deltaZ);
    console.log('deltaMode:', e.deltaMode);   // 0=像素, 1=行, 2=頁
}, { passive: false });

deltaMode 尤其重要:Firefox 在部分環境下會回報「行」而非「像素」,此時數值需乘上行高才是實際捲動量。跨平台處理時應先正規化:

function normalizeWheel(e) {
    var PIXEL_STEP = 10, LINE_HEIGHT = 40, PAGE_HEIGHT = 800;
    var y = e.deltaY, x = e.deltaX;
    if (e.deltaMode === 1) {          // 以「行」為單位
        x *= LINE_HEIGHT;
        y *= LINE_HEIGHT;
    } else if (e.deltaMode === 2) {   // 以「頁」為單位
        x *= PAGE_HEIGHT;
        y *= PAGE_HEIGHT;
    }
    return { x: x, y: y };
}

阻止預設捲動

想在滾輪上自訂縮放或水平滾動時,必須取消預設行為,而這件事有個關鍵陷阱: Chrome 把 wheel 相關監聽器預設設為 passive,此時 preventDefault() 會失效並在 console 出現警告。必須明確關閉 passive:

element.addEventListener('wheel', function (e) {
    e.preventDefault();
    // 自訂的縮放或滾動邏輯
}, { passive: false });

實務建議

攔截滾輪會破壞使用者對頁面的預期操作,也容易造成觸控板手勢(雙指捲動、橡皮筋回彈)異常。若非明確需要(例如自訂的圖表縮放、全螢幕的區塊式捲動),盡量讓瀏覽器自己處理。真要實作時,也別忘了提供鍵盤操作作為替代路徑,以符合無障礙要求。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved