WheelEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* 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 の値の変化を検出するようにしてください。

コンストラクター

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 読取専用非推奨; 非標準