MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

WheelEvent

WheelEvent インターフェイスは、ユーザがマウスホイールやホイールに似たデバイスを動かしたときに発生するイベントを表します。

これは標準のホイールイベントインターフェイスです。

古いバージョンのブラウザは非標準かつブラウザ間の互換性がない、MouseWheelEvent および MouseScrollEvent インターフェイスを実装しています。これら 2 つは避けて、標準のインターフェイスを使用してください。

コンストラクタ

WheelEvent()
WheelEvent オブジェクトを作成します。

プロパティ

このインターフェイスは、親インターフェイスである MouseEventUIEventEvent のプロパティを継承します。

WheelEvent.deltaX 読取専用
水平方向のスクロール量を表す double を返します。
WheelEvent.deltaY 読取専用
垂直方向のスクロール量を表す double を返します。
WheelEvent.deltaZ 読取専用
Z 軸方向のスクロール量を表す double を返します。
WheelEvent.deltaMode 読取専用
スクロール量の差分値の単位を表す unsigned long を返します。許容値は以下のとおりです:
定数 説明
DOM_DELTA_PIXEL 0x00 差分値はピクセル数で指定します。
DOM_DELTA_LINE 0x01 差分値は行数で指定します。
DOM_DELTA_PAGE 0x02 差分値はページ数で指定します。

メソッド

このインターフェイスではメソッドが定義されていませんが、親インターフェイスである MouseEventUIEventEvent のメソッドを継承します。

仕様

仕様書 策定状況 コメント
Document Object Model (DOM) Level 3 Events Specification
WheelEvent の定義
草案 最初期の定義

ブラウザ実装状況

機能 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート 31 (有) 17.0 (17.0) 9.0 18 7.0
window.WheelEvent (有) (有) 17.0 (17.0) 9.0 (有) (有) [1]
機能 Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート (有) 17.0 (17.0) ? (有) 未サポート
window.WheelEvent (有) 17.0 (17.0) ? (有) ?

[1] Safari は、実際は WheelEvent をサポートしていません。しかし、window.WheelEvent のためのオブジェクトを返します。

関連情報

  • wheel
  • このインターフェイスに置き換えられたインターフェイス:
    • Gecko の古いマウスホイールイベントのオブジェクト: MouseScrollEvent
    • Gecko 以外のブラウザの、古いマウスホイールイベントのオブジェクト: MouseWheelEvent

ドキュメントのタグと貢献者

 このページの貢献者: yyss
 最終更新者: yyss,