WheelEvent

WheelEvent DOM 事件會在用戶滚动滑鼠滚轮或操作其它類似滑鼠的設備時觸發。

警告： **該事件爲標準規定的事件介面。**早期的瀏覽器實現過MouseWheelEvent (en-US)和MouseScrollEvent (en-US)兩種滾輪事件介面，但這兩種介面皆非標準，加之各瀏覽器間對其相容性極差。因而開發者應用該標準事件介面取代這兩個非標準介面。

備註： 請勿想當然依據滾輪方向（即該事件的各 delta 屬性值）來推斷文檔內容的滾動方向，因標準未定義滾輪事件具體會引發什麼樣的行爲，引發的行爲實際上是各瀏覽器自行定義的。即便滾輪事件引發了文檔內容的滾動行爲，也不表示滾輪方向和文檔內容的滾動方向一定相同。因而通過該滾輪事件獲知文檔內容滾動方向的方法並不可靠。要獲取文檔內容的滾動方向，可在文檔內容滾動事件（scroll）中監視scrollLeft (en-US)和scrollTop二值變化情況，即可推斷出滾動方向了。

Event UIEvent MouseEvent (en-US) WheelEvent

建構式

WheelEvent() (en-US)

建立一個WheelEvent物件。

屬性

該介面繼承了父介面MouseEvent (en-US)、UIEvent、Event的屬性。

  • WheelEvent.deltaX (en-US) Read only
    • : 返回double值，該值表示滾輪的橫向滾動量。
  • WheelEvent.deltaY (en-US) Read only
    • : 返回double值，該值表示滾輪的縱向滾動量。
  • WheelEvent.deltaZ (en-US) Read only
    • : 返回double值，該值表示滾輪的 z 軸方向上的滾動量。
  • WheelEvent.deltaMode (en-US) Read only
    • : 返回unsigned long值，該值表示上述各 delta 的值的單位。該值及所表示的單位如下： 常數 值 描述
      DOM_DELTA_PIXEL 0x00 滾動量單位爲像素。
      DOM_DELTA_LINE 0x01 滾動量單位爲行。
      DOM_DELTA_PAGE 0x02 滾動量單位爲頁。

方法

該介面本身未定義方法，但繼承了父介面MouseEvent (en-US)、UIEvent、Event的方法。

規範

Specification
UI Events
# interface-wheelevent

瀏覽器相容性

BCD tables only load in the browser

參見