1. Web
  2. Web API
  3. WheelEvent

WheelEvent

Baseline 廣泛可用 *

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

WheelEvent 介面代表使用者透過滑鼠滾輪或類似輸入裝置滾動時發生的事件。

注意: 這是標準的滾輪事件介面。舊版本的瀏覽器實現了非標準且不相容的 MouseWheelEvent 和 MouseScrollEvent 介面。請使用此介面，避免使用非標準介面。

請勿將 wheel 事件與 scroll 事件混淆。

  • wheel 事件不一定會觸發 scroll 事件。例如，元素可能根本無法滾動。使用滾輪或觸控板進行的縮放操作也會觸發 wheel 事件。
  • scroll 事件不一定由 wheel 事件觸發。元素也可以透過鍵盤、拖動捲軸或使用 JavaScript 來滾動。
  • 即使 wheel 事件觸發了滾動，wheel 事件中的 delta* 值也不一定反映內容的滾動方向。
Event UIEvent MouseEvent WheelEvent

建構函式

WheelEvent()

建立一個 WheelEvent 物件。

例項屬性

此介面繼承了其祖先 MouseEvent、UIEvent 和 Event 的屬性。

WheelEvent.deltaX 只讀

返回一個表示水平滾動量的 double 值。

WheelEvent.deltaY 只讀

返回一個表示垂直滾動量的 double 值。

WheelEvent.deltaZ 只讀

返回一個表示 z 軸滾動量的 double 值。

WheelEvent.deltaMode 只讀

返回一個 unsigned long，表示 delta* 值滾動量的單位。

WheelEvent.wheelDelta 只讀

返回一個表示畫素距離的整數（32 位）。

WheelEvent.wheelDeltaX 只讀

返回一個表示水平滾動量的整數。

WheelEvent.wheelDeltaY 只讀

返回一個表示垂直滾動量的整數。

注意: Element: mousewheel event 頁面包含關於已棄用的屬性 wheelDelta、wheelDeltaX、wheelDeltaY 的額外文件。

例項方法

此介面不定義任何特定方法，但繼承自其祖先 MouseEvent、UIEvent 和 Event 的方法。

規範

規範
UI 事件
# interface-wheelevent

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ，由 MDN 貢獻者 修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤
© . Content available under a Creative Commons license.