WheelEvent
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
読取専用 非推奨 Non-standard-
ピクセル単位の距離を表す整数(32 ビット)を返します。
WheelEvent.wheelDeltaX
読取専用 非推奨 Non-standard-
水平スクロール量を表す整数を返します。
WheelEvent.wheelDeltaY
読取専用 非推奨 Non-standard-
垂直スクロール量を表す整数を返します。
メモ: Element: mousewheel イベントには、非推奨の wheelDelta
、wheelDeltaX
、wheelDeltaY
プロパティについての追加の文書があります。
メソッド
このインターフェイスではメソッドが定義されていませんが、祖先である MouseEvent
, UIEvent
, Event
のメソッドを継承しています。
仕様書
Specification |
---|
UI Events # interface-wheelevent |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
-
wheel
イベント -
置き換えたインターフェイス:
- Gecko の古いマウスホイールイベントオブジェクト:
MouseScrollEvent
- Gecko の古いマウスホイールイベントオブジェクト: