DIV CSS 佈局教程網

滑鼠滾輪事件跨瀏覽器全解:wheelDelta 與 detail 的統一處理
編輯:關於JavaScript     

滾輪事件是跨瀏覽器處理最混亂的 API 之一,因為它比鍵盤事件更晚被標準化,各家在標準缺位期間各自發展了一套。以下先還原當時的相容分析,再給出現代答案。

原始示範包含三個應用場景:文本框聚焦後滾動調整數值、滾動縮放圖片、滾動控制滑桿移動。

結構

<style>
  .slider { width: 50px; height: 180px; background: #eee; padding: 10px 0; cursor: n-resize; }
  .slider-slot {
    width: 16px; margin: 0 auto; height: 180px;
    background: #eee; border: 1px solid gray;
    border-color: #999 white white #999;
    position: relative;
  }
  .slider-trigger {
    width: 14px; height: 18px; font: 1px/0 arial;
    border: 1px solid gray; border-color: white #999 #999 white;
    background: #ccc; position: absolute;
  }
  .slider-trigger b {
    display: block; margin: 1px 3px;
    border-top: 1px solid #999; border-bottom: 1px solid white;
  }
</style>

<h2>文本框增加/減少值</h2>
<input type="text" id="txt" value="1440" /> 文本框獲得焦點後滾動滑鼠滾輪

<h2>滑鼠滾動縮放圖片</h2>
<img id="pic" src="https://divcss.yunyiwangluo.com/divcssbuju/UploadFiles_7251/201612/2016122410183110.jpg" />

<h2>滑鼠滾動控制滑塊移動</h2>
<div class="slider">
  <div class="slider-slot">
    <div class="slider-trigger"><b></b></div>
  </div>
</div>

各家瀏覽器的相容情況

IE 6 / 7 / 8

註冊事件用 onmousewheel,取值用 event.wheelDelta。步長為 120,向下是負值、向上是正值。當滑鼠在同一座標且不間斷滾動時,wheelDelta 會按步長遞增(例如 -240、-360)。

Firefox 3.5

註冊事件有兩個:MozMousePixelScroll 與 DOMMouseScroll。但它們不能用 element.onDOMMouseScroll 這種方式註冊,必須用 addEventListener。

Firefox 沒有 wheelDelta,它用 event.detail 來取得滾動資訊。這點做得很奇怪,因為 detail 本身的用途是記錄一個事件在原處(滑鼠座標不變)執行了多少次。在 DOMMouseScroll 發生時,它的值通常是 3 和 -3。

而它的取值方向與 IE 剛好相反:向上是負、向下是正。為什麼說「通常」是 3 和 -3 呢?因為當你按住 Ctrl、Alt 或 Shift 之後再滾動,detail 的值會變成 1 和 -1;按住其他鍵時正值有時還會變成 6。總之有點亂。

MozMousePixelScroll 據 Mozilla 說是幾乎與 DOMMouseScroll 一樣的事件,只是更精確(到像素)。但它的 detail 值返回得非常奇怪,預設是 51 和 -51,按住 Ctrl/Alt/Shift 變成正負 17。所以它被華麗地忽略了。

Chrome

與 IE 保持一致,但考慮到橫向滾輪裝置,額外增加了兩個屬性:

事件:onmousewheel
wheelDelta  {number}
wheelDeltaX {number}
wheelDeltaY {number}

Opera

Opera 又是集大成者,同時有 detail(取值一樣是 3 / -3)與 wheelDelta,表現上倒是蠻一致的。

統一的做法

理論上我們應該從 detail 或 wheelDelta 中選一個,再把另一個換算成一致的值。但實際上,我們從這些值只能知道「向上滾還是向下滾」,所以在實務應用中統一成 +1 與 -1 最方便,後續運算也好處理。

對 IE、Chrome 來說,直接除以 120 就能搞定。

Opera 同時支援兩者,但 detail 沒有 wheelDelta 那種「同一位置遞增」的能力,所以要先判斷 wheelDelta 是否存在:有就用它,沒有才退回 detail。

由於 Firefox 有鍵盤干擾(Ctrl/Alt/Shift 會讓值變成 1 或 6),需要對 detail 做一些過濾:先用這個值對 3 取模。若餘數為 0,說明它是 3 的倍數,除以 3 後回傳(保證是 +1 或 -1);若餘數不為 0,說明這值不是 1 就是 -1,直接回傳即可。

最後,由於 Firefox 的規則是「向上為負、向下為正」,與一般習慣相反,要將正負反轉——在計算結果前面加一個負號就好。

function getWheelValue(e) {
  e = e || event;
  return (e.wheelDelta ? e.wheelDelta / 120
                       : -(e.detail % 3 == 0 ? e.detail : e.detail / 3));
}

這裡有個細節值得指出:第一行用 e.wheelDelta ? 判斷存在性,同樣犯了「值為 0 時誤判」的毛病。雖然 wheelDelta 實務上不會是 0,但嚴謹的寫法應該用 typeof e.wheelDelta != 'undefined'。第二處則是 Opera 的情況:它同時有兩個屬性,而上面的三元運算只要 wheelDelta 存在就用它——這正好符合前面說的優先順序,是正確的。

三個應用場景的實作

// 一、文本框聚焦時滾動調整數值
var txt = document.getElementById('txt');
txt.onmousewheel = txt.onfocus = function () { return false; };
txt.onwheel = function (e) {
  var v = getWheelValue(e);
  this.value = Number(this.value) + (v > 0 ? 1 : -1);
  return false;      // 阻止頁面捲動
};

// 二、滾動縮放圖片
var pic = document.getElementById('pic');
pic.onwheel = function (e) {
  var scale = getWheelValue(e) > 0 ? 1.1 : 0.9;
  this.style.transform = 'scale(' + scale + ')';
  return false;
};

// 三、滾動控制滑塊
var trigger = document.querySelector('.slider-trigger');
var slot = document.querySelector('.slider-slot');
trigger.onwheel = function (e) {
  var v = getWheelValue(e);
  var top = this.offsetTop + (v > 0 ? -4 : 4);
  top = Math.max(0, Math.min(top, slot.clientHeight - this.offsetHeight));
  this.style.top = top + 'px';
  return false;
};

這裡的 return false 是舊式寫法,用來阻止頁面同時捲動。標準做法是 e.preventDefault(),而且——這點很重要——在現代瀏覽器中,若要正確阻止捲動,必須用 { passive: false } 註冊監聽器,因為 wheel 事件預設被視為 passive:

el.addEventListener('wheel', function (e) {
  e.preventDefault();
  // ...
}, { passive: false });

DOM3 與現況

在 DOM Level 3 Event 中,滾輪事件變得更複雜(也支援更多東西)。註冊的事件名稱統一為 wheel,並定義了專門的事件介面 WheelEvent,支援 x、y、z 三個軸向的滾輪值。

今天的標準寫法非常乾淨:

el.addEventListener('wheel', function (e) {
  // e.deltaY < 0 向上,> 0 向下
  // e.deltaMode: 0 = 像素, 1 = 行, 2 = 頁
  var direction = e.deltaY > 0 ? 1 : -1;

  e.preventDefault();
}, { passive: false });

唯一需要留意的是 deltaMode:Firefox 傳統上以「行」為單位(deltaY 為 ±3),而 Chrome 以「像素」為單位(通常 ±100)。若要跨瀏覽器一致的行為,應該依 mode 換算:

function normalizeWheel(e) {
  var unit = e.deltaMode === 1 ? 16      // 行 → 約 16px
           : e.deltaMode === 2 ? window.innerHeight   // 頁
           : 1;                          // 像素
  return e.deltaY * unit;
}

回頭看這段歷史,最值得注意的是「為什麼當年那麼亂」:滾輪裝置的硬體多樣性(有些裝置一次送多格、有些送連續值)、缺少標準、以及各家對「使用者期待」的解讀不同。而最終的標準之所以採取 deltaY + deltaMode 的設計,正是為了把「裝置送出什麼」與「程式如何解讀」分開——由瀏覽器負責正規化,開發者只需處理 mode 差異。這個「把環境差異吸收在平台層」的思路,是所有好的 API 設計共通的原則。

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