WheelEvent

WheelEvent インターフェイスは、ユーザーがマウスホイールやそれに似た機器を動かしたときに発行されるイベントを表します。

重要: これは標準のホイールイベントインターフェイスです。古いバージョンのブラウザーは、標準外でブラウザー間の互換性のない MouseWheelEvent (en-US) および MouseScrollEvent (en-US) インターフェイスを実装していました。これらを避けて、このインターフェイスを使用してください。

注: wheel イベントと scroll イベントを混同しないでください。 wheel イベントの既定のアクションは実装固有のものです。したがって、 wheel イベントは必ずしも scroll イベントを発行するわけではありません。その場合でも、 wheel イベントの delta* 値は必ずしもコンテンツのスクロール方向を反映しているとは限りません。したがって、スクロールの方向を取得するために、 wheel イベントの delta* プロパティに頼らないようにしてください。代わりに、 scroll イベント内のターゲットの scrollLeftscrollTop の値の変化を検出するようにしてください。

コンストラクター

WheelEvent() (en-US)
WheelEvent オブジェクトを生成します。

プロパティ

このインターフェイスは、その祖先である MouseEvent, UIEvent, Event からプロパティを継承しています。

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

メソッド

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

仕様書

仕様書 状態 備考
UI Events
The WheelEvent interface の定義
草案
Document Object Model (DOM) Level 3 Events Specification
WheelEvent の定義
廃止 初回定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報

  • wheel イベント
  • 置き換えたインターフェイス: