WheelEvent
WheelEvent DOM 事件會在用戶滚动滑鼠滚轮或操作其它類似滑鼠的設備時觸發。
警告: **該事件爲標準規定的事件介面。**早期的瀏覽器實現過MouseWheelEvent
(en-US)和MouseScrollEvent
(en-US)兩種滾輪事件介面,但這兩種介面皆非標準,加之各瀏覽器間對其相容性極差。因而開發者應用該標準事件介面取代這兩個非標準介面。
備註: 請勿想當然依據滾輪方向(即該事件的各 delta 屬性值)來推斷文檔內容的滾動方向,因標準未定義滾輪事件具體會引發什麼樣的行爲,引發的行爲實際上是各瀏覽器自行定義的。即便滾輪事件引發了文檔內容的滾動行爲,也不表示滾輪方向和文檔內容的滾動方向一定相同。因而通過該滾輪事件獲知文檔內容滾動方向的方法並不可靠。要獲取文檔內容的滾動方向,可在文檔內容滾動事件(scroll
)中監視scrollLeft
(en-US)和scrollTop
二值變化情況,即可推斷出滾動方向了。
建構式
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
參見
wheel
(en-US)- 該介面取代的過時介面:
MouseScrollEvent
(en-US)(Gecko 內核瀏覽器)MouseWheelEvent
(en-US)(非 Gecko 內核的瀏覽器)