WheelEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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

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

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

Event UIEvent MouseEvent WheelEvent

コンストラクター

WheelEvent()

WheelEvent オブジェクトを生成します。

プロパティ

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

WheelEvent.deltaX 読取専用

水平方向のスクロール量を表す double を返します。

WheelEvent.deltaY 読取専用

垂直方向のスクロール量を表す double を返します。

WheelEvent.deltaZ 読取専用

Z 軸方向のスクロール量を表す double を返します。

WheelEvent.deltaMode 読取専用

スクロール量の差分値の単位を表す unsigned long を返します。許容値は以下のとおりです:

定数 値 説明
DOM_DELTA_PIXEL 0x00 delta* はピクセル数で指定されます。
DOM_DELTA_LINE 0x01 delta* は行数で指定されます。マウスをクリックするたびに、コンテンツを 1 行スクロールします。行の高さを計算するために使用する方法は、ブラウザーに依存します。
DOM_DELTA_PAGE 0x02 delta* はページ数で指定されます。マウスをクリックするたびに、コンテンツを 1 ページスクロールします。
WheelEvent.wheelDelta 読取専用

ピクセル単位の距離を表す整数（32 ビット）を返します。

WheelEvent.wheelDeltaX 読取専用

水平スクロール量を表す整数を返します。

WheelEvent.wheelDeltaY 読取専用

垂直スクロール量を表す整数を返します。

メモ: Element: mousewheel イベントには、非推奨の wheelDelta、wheelDeltaX、wheelDeltaY プロパティについての追加の文書があります。

メソッド

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

仕様書

Specification
UI Events
# interface-wheelevent

ブラウザーの互換性

関連情報

  • wheel イベント

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

    • Gecko の古いマウスホイールイベントオブジェクト: MouseScrollEvent