ポインターイベント

WebIDL[Exposed=Window]
interface MouseEvent : UIEvent {
	constructor(DOMString type, optional MouseEventInit eventInitDict = {});
	readonly attribute long screenX;
	readonly attribute long screenY;
	readonly attribute long clientX;
	readonly attribute long clientY;
	readonly attribute long layerX;
	readonly attribute long layerY;

	readonly attribute boolean ctrlKey;
	readonly attribute boolean shiftKey;
	readonly attribute boolean altKey;
	readonly attribute boolean metaKey;

	readonly attribute short button;
	readonly attribute unsigned short buttons;

	readonly attribute EventTarget? relatedTarget;

	boolean getModifierState(DOMString keyArg);
};

screenX

イベントが発生した水平座標（スクリーン座標系の原点に対する相対位置）。

この属性の 未初期化値 は MUST 0 でなければならない。

screenY

イベントが発生した垂直座標（スクリーン座標系の原点に対する相対位置）。

この属性の 未初期化値 は MUST 0 でなければならない。

clientX

イベントに関連付けられたビューポートの原点に対する、イベントが発生した水平座標。

この属性の 未初期化値 は MUST 0 でなければならない。

clientY

イベントに関連付けられたビューポートの原点に対する、イベントが発生した垂直座標。

この属性の 未初期化値 は MUST 0 でなければならない。

layerX

最も近い 祖先 要素（それがスタッキングコンテキストである、positionedである、または スタッキングコンテキストを描画する際に positioned フェーズで描画される）からの水平オフセット。

この属性の 未初期化値 は MUST 0 でなければならない。

layerY

最も近い 祖先 要素（それがスタッキングコンテキストである、positionedである、または スタッキングコンテキストを描画する際に positioned フェーズで描画される）からの垂直オフセット。

この属性の 未初期化値 は MUST 0 でなければならない。

ctrlKey

KeyboardEvent の ctrlKey 属性を参照。

この属性の 未初期化値 は MUST false でなければならない。

shiftKey

KeyboardEvent の shiftKey 属性を参照。

この属性の 未初期化値 は MUST false でなければならない。

altKey

KeyboardEvent の altKey 属性を参照。

この属性の 未初期化値 は MUST false でなければならない。

metaKey

KeyboardEvent の metaKey 属性を参照。

この属性の 未初期化値 は MUST false でなければならない。

button

マウスボタンの押下または解放によって引き起こされるmouseイベントの間、button は、どのポインタデバイスのボタンが状態を変更したかを示すために MUST 使用されなければならない。

button 属性の値は、次のとおりで MUST である：

• 0 はデバイスの主ボタン（一般に左ボタン、または単一ボタンデバイスの唯一のボタンで、UIコントロールのアクティベートやテキスト選択に使用される）または未初期化値を示すものとして MUST である。
• 1 は補助ボタン（一般に中央ボタンで、しばしばマウスホイールと組み合わされる）を示すものとして MUST である。
• 2 は副ボタン（一般に右ボタンで、しばしばコンテキストメニューの表示に用いられる）を示すものとして MUST である。
• 3 は X1（戻る）ボタンを示すものとして MUST である。
• 4 は X2（進む）ボタンを示すものとして MUST である。

一部のポインティングデバイスは、より多くのボタン状態を提供またはシミュレートするため、そのようなボタンを表すために 2 より大きい値または 0 より小さい値を MAY 用いてよい。

注記

button の値は、マウスボタンの押下／解放によって引き起こされないイベントでは更新されない。これらのシナリオでは、値 0 を左ボタンとして解釈せず、デフォルト値として扱うよう注意すること。

注記

mousedown や mouseup などのイベントに関連する一部の デフォルト動作 は、使用中の特定のマウスボタンに依存する。

この属性の 未初期化値 は MUST 0 でなければならない。

buttons

いかなるmouseイベントの間も、buttons は、現在押下されているマウスボタンの組み合わせを、ビットマスクとして表現して示すために MUST 使用されなければならない。

注記

名前は似ているが、buttons 属性と button 属性の値は大きく異なる。button の値は mousedown / mouseup イベントハンドラーの間に有効であると仮定される一方、buttons 属性は、任意の信頼された MouseEvent オブジェクト（ディスパッチ中）のボタン状態を反映する。これは、「現在アクティブなボタンがない」状態（0）を表現できるためである。

buttons 属性の値は、次のとおりで MUST である：

• 0 は、現在アクティブなボタンがないことを示すものとして MUST である。
• 1 はデバイスの主ボタン（一般に左ボタン、または単一ボタンデバイスの唯一のボタンで、UIコントロールのアクティベートやテキスト選択に使用される）を示すものとして MUST である。
• 2 は（存在する場合）副ボタン（一般に右ボタンで、しばしばコンテキストメニューの表示に用いられる）を示すものとして MUST である。
• 4 は補助ボタン（一般に中央ボタンで、しばしばマウスホイールと組み合わされる）を示すものとして MUST である。

一部のポインティングデバイスは、より多くのボタンを提供またはシミュレートする。そのようなボタンを表すため、値はボタンが増えるごとに倍増されるものとして MUST である（2進系列 8、16、32、...）。

注記

任意のボタン値集合の合計は一意の数になるため、コンテンツ著者はビット演算を用いて、デバイス上の任意個数のマウスボタンについて、現在押下されているボタン数とどのボタンが押下されているかを判定できる。例えば、値 3 は左ボタンと右ボタンが同時に押下されていることを示し、値 5 は左ボタンと中央ボタンが同時に押下されていることを示す。

注記

mousedown や mouseup などのイベントに関連する一部の デフォルト動作 は、使用中の特定のマウスボタンに依存する。

この属性の 未初期化値 は MUST 0 でなければならない。

relatedTarget

イベントの種類に応じて、UIイベントに関連する二次的な EventTarget を識別するために使用される。

この属性の 未初期化値 は MUST null でなければならない。

getModifierState(keyArg)

キー値を用いて修飾キーの状態を問い合わせる。

それが修飾キーであり、かつ修飾が有効なら true を返し、それ以外は false を返す。

DOMString keyArg

このパラメータの説明は、KeyboardEvent の getModifierState() メソッドを参照。

WebIDLdictionary MouseEventInit : EventModifierInit {
	long screenX = 0;
	long screenY = 0;
	long clientX = 0;
	long clientY = 0;

	short button = 0;
	unsigned short buttons = 0;
	EventTarget? relatedTarget = null;
};

screenX

screenX 属性を、ユーザーのスクリーン上におけるマウスポインタの望ましい水平相対位置に、MouseEvent オブジェクト内で初期化する。

与えられたマウス位置でイベントオブジェクトを初期化しても、ユーザーのマウスポインタを初期化位置へ移動させてはならない。

screenY

screenY 属性を、ユーザーのスクリーン上におけるマウスポインタの望ましい垂直相対位置に、MouseEvent オブジェクト内で初期化する。

与えられたマウス位置でイベントオブジェクトを初期化しても、ユーザーのマウスポインタを初期化位置へ移動させてはならない。

clientX

clientX 属性を、ユーザーのブラウザーのクライアントウィンドウに対するマウスポインタの望ましい水平位置に、MouseEvent オブジェクト内で初期化する。

与えられたマウス位置でイベントオブジェクトを初期化しても、ユーザーのマウスポインタを初期化位置へ移動させてはならない。

clientY

clientY 属性を、ユーザーのブラウザーのクライアントウィンドウに対するマウスポインタの望ましい垂直位置に、MouseEvent オブジェクト内で初期化する。

与えられたマウス位置でイベントオブジェクトを初期化しても、ユーザーのマウスポインタを初期化位置へ移動させてはならない。

button

button 属性を、マウスのボタンの望ましい状態を表す数値として、MouseEvent オブジェクト内で初期化する。

注記

値 0 は主マウスボタンを表すために使用され、1 は補助／中央マウスボタンを表すために使用され、2 は右マウスボタンを表すために使用される。2 より大きい数値も可能だが、本書では規定しない。

buttons

buttons 属性を、アクティブとみなされるマウスのボタンのうちの 1つ以上 を表す数値として、MouseEvent オブジェクト内で初期化する。

注記

buttons 属性はビットフィールドである。ビットフィールド値にマスク値 1 を適用したときに真であれば、主マウスボタンが押下されている。マスク値 2 を適用したときに真であれば、右マウスボタンが押下されている。マスク値 4 を適用したときに真であれば、補助／中央ボタンが押下されている。

JavaScriptでは、右（2）および中央ボタン（4）が同時に押下されているかのように buttons 属性を初期化するには、buttons 値を次のいずれかとして代入できる：

{ buttons: 2 | 4 }

または：

{ buttons: 6 }

relatedTarget

relatedTarget は、マウスポインタがちょうど離れた境界を持つ要素（mouseover または mouseenter イベントの場合）または、マウスポインタが侵入しつつある境界を持つ要素（mouseout または mouseleave または focusout イベントの場合）として初期化されるべきである。その他のイベントでは、この値は代入する必要はない（既定値は null となる）。

実装は、mouseイベント生成時に 現在のクリック数 を維持しなければならない（MUST）。これは、特定時間内にポインティングデバイスのボタンが連続クリックされた回数を示す非負整数でなければならない（MUST）。カウントがリセットされるまでの遅延は、環境設定に固有である。

このセクションのアルゴリズムは、ネイティブプラットフォーム OS が次のものを提供することを前提とする：

• マウスが移動したときのイベント（handle native mouse move により処理される）
• マウスボタンが押下されたときのイベント（handle native mouse down により処理される）
• マウスボタンが解放されたときのイベント（handle native mouse up により処理される）
• マウスボタン押下が「クリック」と解釈されるべきタイミングを識別する方法（handle native mouse click により処理される）
  • 例えば、フラグとして、または別個のイベントとして
  • 別個の「click」イベントが発火される場合、ネイティブ OS は対応する「mouse up」イベントの直後に、間にマウス関連イベントを挟まずにそれを発火する
• マウスクリックが「ダブルクリック」であるタイミングを識別する方法（handle native mouse double click により処理される）

これらのイベントについて、OS は次の情報を提供できる：

• ネイティブ OS デスクトップに対する x,y マウス座標
• UA のウィンドウビューポートに対する x,y マウス座標
• 現在押下されているキーボード修飾キー

一般に、Event インターフェース、または Event インターフェースを継承するインターフェースのコンストラクターが呼び出された場合、[DOM] に記述された手順に従うべきである。しかし MouseEvent インターフェースは、Event オブジェクトのキー修飾子に関する内部状態を初期化するための追加ディクショナリメンバーを提供する。具体的には、getModifierState() メソッドで問い合わせられる内部状態である。このセクションは、これら任意の修飾子状態を用いて新しい MouseEvent オブジェクトを初期化するための、[DOM] の手順を補足する。

MouseEvent（または、以下のアルゴリズムを用いてそれらから派生したオブジェクト）を構築する目的において、すべての MouseEvent および派生オブジェクトは、internal key modifier state を持つ。これは、[UIEvents-Key] の Modifier Keys table で記述される key modifier names を用いて、設定および取得できる。

次の手順は、[DOM] で定義されたイベント構築アルゴリズムを補足する：

• 構築される Event が MouseEvent オブジェクト、またはそれから派生したオブジェクトであり、かつコンストラクターに EventModifierInit 引数が提供された場合、次のサブステップを実行する：
  • 各 EventModifierInit 引数について、ディクショナリメンバーが文字列 "modifier" で始まるなら、key modifier name を、接頭辞 "modifier" を除いたディクショナリメンバー名とし、Event オブジェクトの internal key modifier state のうち、その key modifier name に一致するものを、対応する値に設定する。

MouseEvent は、各種修飾キーの状態を追跡するために用いられる次の内部フラグを持つ： shift flag、 control flag、 alt flag、 altgraph flag、 および meta flag。 これらのフラグは、mouseイベント発生時点で対応する修飾キーが押下されていた場合に設定される。

1. pos を、ビューポートに対する相対 x,y 座標とする
2. [CSSOM-View] の elementFromPoint() を pos で呼び出した結果（pos における最前面の DOM 要素）を返す
   注記

   inert または disabled 要素を考慮するため、これは elementsFromPoint() を呼び出し、無効な要素を除外すべきである。

event、eventType、eventTarget、bubbles、および cancelable を用いて initialize a MouseEvent を行うには、次の手順を実行する：

1. event、eventType、eventTarget、bubbles、および cancelable を用いて UIEvent を初期化する。
2. event.screenX を、デスクトップの原点に対する相対位置として、イベントが発生した位置の x 座標に設定する
3. event.screenY を、デスクトップの原点に対する相対位置として、イベントが発生した位置の y 座標に設定する
4. event.clientX を、viewport の原点に対する相対位置として、イベントが発生した位置の x 座標に設定する
5. event.clientY を、viewport の原点に対する相対位置として、イベントが発生した位置の y 座標に設定する
6. Set mouse event modifiers を event に対して実行する
7. event.button を 0 に設定する
8. event.buttons を mouse button bitmask に設定する
9. event に対して MouseEvent の PointerLock 属性を初期化する
   Issue 1

   ここにハードコードするのではなく、PointerLock のためのフックを提供すべきである。

1. 更新対象の MouseEvent を event とする
2. key modifier state に "Shift" が含まれる場合、event の shift flag を設定し、それ以外の場合は解除する
3. key modifier state に "Control" が含まれる場合、event の control flag を設定し、それ以外の場合は解除する
4. key modifier state に "Alt" が含まれる場合、event の alt flag を設定し、それ以外の場合は解除する
5. key modifier state に "AltGraph" が含まれる場合、event の altgraph flag を設定し、それ以外の場合は解除する
6. key modifier state に "Meta" が含まれる場合、event の meta flag を設定し、それ以外の場合は解除する
7. event.shiftKey を、イベントの shift flag が設定されている場合は true、そうでない場合は false に設定する
8. event.ctrlKey を、イベントの control flag が設定されている場合は true、そうでない場合は false に設定する
9. event.altKey を、イベントの alt flag または altgraph flag が設定されている場合は true、そうでない場合は false に設定する
10. event.metaKey を、イベントの meta flag が設定されている場合は true、そうでない場合は false に設定する

1. eventType を、有効な MouseEvent 型を含む DOMString とする
2. eventTarget を、イベントの EventTarget とする
3. bubbles を true とする
4. cancelable を true とする
5. creating an event を用いて MouseEvent により作成した結果を event とする
6. Initialize a MouseEvent を event、eventType、eventTarget、bubbles、および cancelable で行う。
7. event を返す

1. eventType を、有効な MouseEvent 型を含む DOMString とする
2. eventTarget を、イベントの EventTarget とする
3. bubbles を "false" とする
4. cancelable を "false" とする
5. creating an event を用いて MouseEvent により作成した結果を event とする
6. Initialize a MouseEvent を event、eventType、eventTarget、bubbles、および cancelable で行う。
7. event を返す

これは、MouseEvent の button 属性に格納するのに適した button ID を返す。

1. mbutton を、マウスボタンを識別する ID とする
2. mbutton が主マウスボタンなら、0 を返す
3. mbutton が補助（中央）マウスボタンなら、1 を返す
4. mbutton が副マウスボタンなら、2 を返す
5. mbutton が X1（戻る）ボタンなら、3 を返す
6. mbutton が X2（進む）ボタンなら、4 を返す

1. 初期化対象の MouseEvent を event とする
2. native をネイティブのマウスイベントとする
   編集者注

   TODO。

3. event.type が [ mousedown, mouseup ] のいずれかなら、
   1. native から、どのマウスボタンが押下されたかを識別する ID を mbutton とする
   2. event.button を、 mbutton に対して calculate MouseEvent button attribute を行った結果に設定する

1. native をネイティブ mousedown とする
2. native から、どのマウスボタンが押下されたかを識別する ID を mbutton とする
3. mouse button bitmask を次のとおり更新する：
   1. mbutton が主マウスボタンなら、0x01 ビットを設定する
   2. mbutton が副マウスボタンなら、0x02 ビットを設定する
   3. mbutton が補助（中央）マウスボタンなら、0x04 ビットを設定する
      注記

      他のボタンは 0x08 から追加できる。

4. native のビューポート相対座標を用いて hit test を行った結果を target とする
5. "mousedown" と target で creating a cancelable MouseEvent を行った結果を event とする
6. native に対して Set MouseEvent attributes from native を行う
7. event に対して Maybe send pointerdown event を行う
8. dispatch により target へ event をディスパッチした結果を result とする
9. result が true であり、かつ target が focusable area であり、かつ click focusable であるなら、
   1. target で focusing steps を実行する
10. mbutton が副マウスボタンなら、
    1. native と target に対して Maybe show context menu を行う

1. native をネイティブ mouseup とする
   注記

   mousedown と mouseup の間に、他のmouseイベントが発生することがある。

2. native から、どのマウスボタンが押下されたかを識別する ID を mbutton とする
3. mouse button bitmask を次のとおり更新する：
   1. mbutton が主マウスボタンなら、0x01 ビットをクリアする
   2. mbutton が副マウスボタンなら、0x02 ビットをクリアする
   3. mbutton が補助（中央）マウスボタンなら、0x04 ビットをクリアする
4. native のビューポート相対座標を用いて hit test を行った結果を target とする
5. "mouseup" と target で creating a cancelable MouseEvent を行った結果を event とする
6. native に対して Set MouseEvent attributes from native を行う
7. event に対して Maybe send pointerup event を行う
8. dispatch により target へ event をディスパッチする

1. native をネイティブ mouse click とする
   注記

   プラットフォームは、クリックを生成する mouseup に対して、handle native mouse up の直後にこれを呼び出すべきである。

2. native のビューポート相対座標を用いて hit test を行った結果を target とする
3. native と target で Send click event を行う。

1. native をネイティブ mousedown とする
2. target を、イベントの EventTarget とする
3. mbutton を 1（既定では主マウスボタン）とする
4. native が有効なら、
   1. native から、どのマウスボタンが押下されたかを識別する ID を mbutton とする
5. mbutton が主マウスボタンなら eventType を "click" に、そうでなければ "auxclick" に設定する
6. eventType と target で creating a PointerEvent を行った結果を event とする
7. native が有効なら、
   1. event と native で Set MouseEvent attributes from native を行う
   2. event.screenX が整数値でないなら、丸める。
   3. event.screenY が整数値でないなら、丸める。
8. dispatch により target へ event をディスパッチする
   注記

   PointerEvents を使用するブラウザーと丸められた座標についての情報は pointerevents/100 を参照。

   編集者注

   いかなる「default action」も、ターゲットに対する activation behavior アルゴリズムをトリガーすることで、ディスパッチ中に処理される。したがって、ここでそれを扱う必要はない。 ただし、既存の仕様が disabled/css-pointer-events/inert/... を処理することを検証する必要がある。

   注記

   HTMLelement.click() を扱うには、このアルゴリズムを native = null、target = HTMLelement で呼び出す。

   注記

   キーボード起点のクリックを扱うには、このアルゴリズムを native = null および target = 現在フォーカスされている要素 で呼び出す。

1. native をネイティブ mouse double click とする
   注記

   これは、ダブルクリックを生成する mouse click に対して、handle native mouse click の直後に呼び出されるべきである。

2. native から、どのマウスボタンが押下されたかを識別する ID を mbutton とする
3. mbutton が主マウスボタンでないなら、return
4. native のビューポート相対座標を用いて hit test を行った結果を target とする
5. "dblclick" と target で creating a PointerEvent を行った結果を event とする
6. event と native で Set MouseEvent attributes from native を行う
7. event.screenX が整数値でないなら、丸める。
8. event.screenY が整数値でないなら、丸める。
9. dispatch により target へ event をディスパッチする

1. native をネイティブ mouse move とする
   Issue 2

   このアルゴリズムは PointerEvents のディスパッチに関して、現時点で明示的に規定されていない前提を置いている。pointerevents/285 が 解決されたら、更新が必要になるかもしれない。

2. native のビューポート相対座標を用いて hit test を行った結果を target とする
3. target の inclusive ancestors を targetDomPath とする
4. 現在の要素から離れるためのイベントを生成する：
   1. last mouse element が定義されており、かつ target と等しくないなら、
      1. "mouseout" と last mouse element で creating a cancelable MouseEvent を行った結果を mouseout とする
         編集者注

         TODO: mouseout 属性を native から設定する。+CSSOM 属性。

   2. mouseout で Maybe send pointerout event を行う
   3. Dispatch により target へ mouseout をディスパッチする
      注記

      キャンセルされた場合の挙動を検証する（影響はないように見える）。

   4. last mouse DOM path のコピーから targetDomPath と共通の全要素を削除したものを leaveElements とする。
   5. leaveElements 内の各 element について、次を行う：
      編集者注

      element が削除された場合を扱う。 移動された場合も扱う：DOM 変更によって mouseleave イベントがトリガーされるべきだったか？今送るべきか？破棄すべきか？ 現在のブラウザーの挙動を検証する必要がある。

      1. "mouseleave" と element で creating a non-cancelable MouseEvent を行った結果を mouseleave とする
      2. mouseleave.Event.composed = false に設定する
         注記

         互換性を確認：event.composed の値。仕様では false。Chrome/Linux = true。Firefox/Linux = false。

      3. mouseleave で Maybe send pointerleave event を行う
      4. dispatch により element へ mouseleave をディスパッチした結果を result とする
5. 新しい要素へ入るためのイベントを生成する：
   1. target が last mouse element でないなら、
      1. "mouseover" と target で creating a cancelable MouseEvent を行った結果を mouseover とする
         編集者注

         TODO: mouseout 属性を native から設定する。+CSSOM 属性。

      2. mouseover で Maybe send pointerover event を行う
      3. Dispatch により target へ mouseout をディスパッチする
         注記

         キャンセルされた場合の挙動を検証する必要がある（影響はないように見える）。

      4. targetDomPath のコピーから、last mouse DOM path と共通の全要素を削除したものを enterElements とする。
      5. enterElements 内の各 element について、次を行う：
         注記

         element が削除または移動された場合を扱う。

         1. "mouseenter" と element で creating a non-cancelable MouseEvent を行った結果を mouseenter とする
         2. mouseenter.Event.composed = false に設定する
            注記

            互換性を確認：event.composed の値。仕様では false。 Chrome/Linux = true。 Firefox/Linux = false。

         3. mouseenter で Maybe send pointerenter event を行う
            注記

            shadow DOM 要素に関する互換性を確認する。Chrome/Linux はこのイベントを要素とシャドウルートで発火する。

         4. dispatch により element へ mouseenter をディスパッチした結果を result とする
      6. last mouse element を target に設定する
      7. last mouse DOM path を targetDomPath に設定する
6. "mousemove" と element で creating a cancelable MouseEvent を行った結果を mousemove とする
7. Set PointerLock attributes for mousemove
8. mousemove で Maybe send pointermove event を行う
9. Dispatch により element へ mousemove をディスパッチする

1. native をネイティブ mousedown または pointer event とする
2. target を、イベントの EventTarget とする
   1. "contextmenu" と target で creating a PointerEvent を行った結果を menuevent とする
   2. native が有効なら、
      1. native に対して Set MouseEvent attributes from native を行う
   3. dispatch により target へ menuevent をディスパッチした結果を result とする
   4. result が true なら、UA コンテキストメニューを表示する

auxclick イベント種別は、ユーザーが非主ポインタボタンを押下して解放したとき、またはそれをシミュレートする方法でポインタをアクティベートしたとき、ポインタが示す 最上位の イベントターゲットへディスパッチされなければならない（MUST）。マウスボタンの作動方法はポインタデバイスと環境設定に依存し、例えば、画面位置またはポインティングデバイスボタンの押下と解放の間の遅延に依存してもよい（MAY）。

auxclick イベントは、非主ポインタ ボタンに対してのみ発火されるべきである（すなわち、button 値が 0 ではなく、 buttons 値が 1 より大きい場合）。主ボタン （標準的なマウスの左ボタンなど）は、auxclick イベントを発火してはならない（MUST NOT）。主ボタンに関連付けられた対応イベントについては、click を参照。

auxclick イベントに先行して、同一要素上での mousedown および mouseup イベントが発生してもよい（MAY）。ここでは、他のノード種別（例：テキストノード）間での変化は無視する。環境設定に応じて、押下と解放の間に mouseover、 mousemove、および mouseout のうち1つ以上のイベント種別が発生した場合でも、 auxclick イベントがディスパッチされてもよい（MAY）。

auxclick イベント種別の デフォルト動作 は、イベントの target および button または buttons 属性の値に応じて変化する。auxclick イベント種別の典型的な デフォルト動作 は次のとおりである：

• target に関連付けられた activation behavior がある場合、 デフォルト 動作は、その activation behavior を実行することでなければならない（MUST）。

myLink.addEventListener("auxclick", function(e) {
  if (e.button === 1) {
    // This would prevent the default behavior which is for example
    // opening a new tab when middle clicking on a link.
    e.preventDefault();
    // Do something else to handle middle button click like taking
    // care of opening link or non-link buttons in new tabs in a way
    // that fits the app. Other actions like closing a tab in a tab-strip
    // which should be done on the click action can be done here too.
  }
});

myDiv.addEventListener("contextmenu", function(e) {
  // This call makes sure no context menu is shown
  // to interfere with page receiving the events.
  e.preventDefault();
});
myDiv.addEventListener("auxclick", function(e) {
  if (e.button === 2) {
    // Do something else to handle right button click like opening a
    // customized context menu inside the app.
  }
});

click イベント種別は、ユーザーが主ポインタボタンを押下して解放したとき、またはそれをシミュレートする方法でポインタをアクティベートしたとき、ポインタが示す 最上位の イベントターゲットへディスパッチされなければならない（MUST）。マウスボタンの作動方法はポインタデバイスと環境設定に依存し、例えば、画面位置またはポインティングデバイスボタンの押下と解放の間の遅延に依存してもよい（MAY）。

click イベントは、主ポインタ ボタンに対してのみ発火されるべきである（すなわち、button 値が 0 であり、 buttons 値が 1 の場合）。 副ボタン （標準的なマウスの中央ボタンや右ボタンなど）は、click イベントを発火してはならない（MUST NOT）。非主ボタンに関連付けられた対応イベントについては、auxclick を参照。

click イベントに先行して、同一要素上での mousedown および mouseup イベントが発生してもよい（MAY）。ここでは、他のノード種別（例：テキストノード）間での変化は無視する。環境設定に応じて、押下と解放の間に mouseover、 mousemove、および mouseout のうち1つ以上のイベント種別が発生した場合でも、 click イベントがディスパッチされてもよい（MAY）。 click イベントの後に、dblclick イベントが続いてもよい（MAY）。

もしユーザーが、大きな line-height でスタイルされた <p> 要素のテキストノード子に対して mousedown し、マウスをわずかに移動して、もはやテキストを含む領域の上ではないが、その <p> 要素の包含ブロック内には依然としてある（すなわち、ポインタは同一テキストブロックの行間にあるが、テキストノード自体の上ではない）ようにし、その後 mouseup した場合、ユーザーが同一要素の範囲内に留まっているため、（click に対する通常の時間的 hysteresis の範囲内であれば）click イベントを依然としてトリガーする可能性が高い。ユーザーエージェントが生成するmouseイベントはテキストノードに対してはディスパッチされないことに留意すること。

ポインタデバイスとの関連付けに加えて、click イベント種別は、要素アクティベーションの一部としてディスパッチされなければならない（MUST）。

click イベント種別の デフォルト動作 は、イベントの target および button または buttons 属性の値に応じて変化する。click イベント種別の典型的な デフォルト動作 は次のとおりである：

• If the target has associated activation behavior, the default action MUST be to execute that activation behavior.
• If the target is focusable, the default action MUST be to give that element document focus.

user agent は、コンテキストメニューを起動する前にこのイベントをディスパッチしなければならない（MUST）。

contextmenu イベントが右マウスボタンによってトリガーされる場合、 contextmenu イベントは mousedown イベントの後にディスパッチされなければならない（MUST）。

user agent は、ポインティングデバイスの主ボタンが要素上で2回クリックされたとき、このイベントをディスパッチしなければならない（MUST）。ダブルクリックの定義は環境設定に依存するが、mousedown、mouseup、および dblclick の間でイベントターゲットは同一でなければならない（MUST）。クリックとダブルクリックが同時に発生する場合、このイベント種別はイベント種別 click の後にディスパッチされなければならず（MUST）、それ以外の場合はイベント種別 mouseup の後にディスパッチされなければならない（MUST）。

click イベントと同様に、dblclick イベントは 主ポインタボタンに対してのみ発火されるべきである。副ボタンは dblclick イベントを発火してはならない（MUST NOT）。

マルチポインタ（例：マルチタッチ）シナリオでは、isPrimary プロパティは、各ポインタ種別ごとに active pointers の集合の中からマスターとなるポインタを識別するために使用される。

• 任意の時点で、各ポインタ種別につき primary pointer は高々1つしか存在しない。
• 特定のポインタ種別で最初に active になったポインタ（例：マルチタッチ操作で最初に画面に触れた指）が、そのポインタ種別の primary pointer になる。
• primary pointer のみが compatibility mouse events を生成する。複数の primary pointers がある場合、それらのポインタはすべて compatibility mouse events を生成する。

e という名前の pointer event を発火するとは、event を発火することにより、e という名前のイベントを PointerEvent を用いて発火し、その属性を PointerEvent インターフェイスおよび 属性と既定動作で定義されるとおりに設定することを意味する。

イベントが gotpointercapture、lostpointercapture、click、 auxclick、または contextmenu イベントでない場合、この PointerEvent について 保留中の pointer capture を処理する手順を実行する。

イベントが発火されるターゲットを次のとおり 決定する：

• ポインタに対して pointer capture target override が設定されている場合、ターゲットを pointer capture target override オブジェクトに設定する。
• それ以外の場合、ターゲットを hit test が返すオブジェクトに設定する。

targetDocument を、ターゲットの node document とする [DOM]。

イベントが pointerdown、pointermove、または pointerup の場合、イベントの active document を、このイベントの pointerId に対して targetDocument に設定する。

イベントが pointerdown であり、関連付けられたデバイスが direct manipulation device で、かつターゲットが Element の場合、暗黙の pointer capture で記述されるとおり、当該 pointerId に対してターゲット要素へ pointer capture を設定する。

このイベントを発火する前に、user agent は、イベント順序を保証する目的で、ターゲットを previousTarget からポインティングデバイスが移動して上に来たものとして扱うべきである（SHOULD） [UIEVENTS]。needsOverEvent フラグが設定されている場合、ターゲット要素が同一であっても pointerover イベントが必要である。

決定されたターゲットへイベントを発火する。

決定されたターゲットを、そのポインタに対する previousTarget として保存し、needsOverEvent フラグを false にリセットする。 ある時点で previousTarget が connected [DOM] ではなくなる場合、previousTarget を、previousTarget にイベントをディスパッチすることに対応するイベントパスに従い、最も近い still connected [DOM] な親へ更新し、needsOverEvent フラグを true に設定する。

画面表面に対して相対的に移動した、またはそのプロパティのいずれかに何らかの変化が生じたポインティングデバイスは、Pointer Event 種別で定義されるさまざまなイベントを発火する。静止したポインティングデバイス（画面表面に対する相対移動も、いずれかのプロパティ変化もない）については、user agent は、ポインタに対する hit test ターゲットに影響を与えたレイアウト変更の後に、特定の境界イベントを発火しなければならない（MUST）。詳細は pointerover、pointerenter、pointerout および pointerleave を参照。user agent は性能上の理由により、これらの境界イベントの発火を遅延してもよい（MAY）（例：境界イベントリスナーにより多すぎる hit-test やレイアウト変更が起こることを避けるため）。

Pointer Events には、X-Y 平面に対するトランスデューサの向きを表すための相補的な2組の属性が含まれる： tiltX / tiltY（元の Pointer Events 仕様で導入）と、 azimuthAngle / altitudeAngle（Touch Events - Level 2 仕様から採用）。

特定のハードウェアおよびプラットフォームに応じて、user agent は画面平面に対するトランスデューサの向きとして、片方の組の値のみを受け取る可能性が高い — すなわち tiltX / tiltY か、altitudeAngle / azimuthAngle のいずれかである。user agent は、これらの値を変換するために次のアルゴリズムを使用しなければならない（MUST）。

user agent が azimuthAngle / altitudeAngle から tiltX / tiltY を計算する場合、最終的な整数値を Math.round [ECMASCRIPT] の規則に従って丸めるべきである（SHOULD）。

/* Converting between tiltX/tiltY and altitudeAngle/azimuthAngle */

function spherical2tilt(altitudeAngle, azimuthAngle) {
  const radToDeg = 180/Math.PI;

  let tiltXrad = 0;
  let tiltYrad = 0;

  if (altitudeAngle == 0) {
    // the pen is in the X-Y plane
    if (azimuthAngle == 0 || azimuthAngle == 2*Math.PI) {
      // pen is on positive X axis
      tiltXrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI/2) {
      // pen is on positive Y axis
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI) {
      // pen is on negative X axis
      tiltXrad = -Math.PI/2;
    }
    if (azimuthAngle == 3*Math.PI/2) {
      // pen is on negative Y axis
      tiltYrad = -Math.PI/2;
    }
    if (azimuthAngle>0 && azimuthAngle<Math.PI/2) {
      tiltXrad = Math.PI/2;
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle>Math.PI/2 && azimuthAngle<Math.PI) {
      tiltXrad = -Math.PI/2;
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle>Math.PI && azimuthAngle<3*Math.PI/2) {
      tiltXrad = -Math.PI/2;
      tiltYrad = -Math.PI/2;
    }
    if (azimuthAngle>3*Math.PI/2 && azimuthAngle<2*Math.PI) {
      tiltXrad = Math.PI/2;
      tiltYrad = -Math.PI/2;
    }
  }

  if (altitudeAngle != 0) {
    const tanAlt = Math.tan(altitudeAngle);

    tiltXrad = Math.atan(Math.cos(azimuthAngle) / tanAlt);
    tiltYrad = Math.atan(Math.sin(azimuthAngle) / tanAlt);
  }

  return {"tiltX":tiltXrad*radToDeg, "tiltY":tiltYrad*radToDeg};
}

function tilt2spherical(tiltX, tiltY) {
  const tiltXrad = tiltX * Math.PI/180;
  const tiltYrad = tiltY * Math.PI/180;

  // calculate azimuth angle
  let azimuthAngle = 0;

  if (tiltX == 0) {
    if (tiltY > 0) {
      azimuthAngle = Math.PI/2;
    }
    else if (tiltY < 0) {
      azimuthAngle = 3*Math.PI/2;
    }
  } else if (tiltY == 0) {
    if (tiltX < 0) {
      azimuthAngle = Math.PI;
    }
  } else if (Math.abs(tiltX) == 90 || Math.abs(tiltY) == 90) {
    // not enough information to calculate azimuth
    azimuthAngle = 0;
  } else {
    // Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
    const tanX = Math.tan(tiltXrad);
    const tanY = Math.tan(tiltYrad);

    azimuthAngle = Math.atan2(tanY, tanX);
    if (azimuthAngle < 0) {
      azimuthAngle += 2*Math.PI;
    }
  }

  // calculate altitude angle
  let altitudeAngle = 0;

  if (Math.abs(tiltX) == 90 || Math.abs(tiltY) == 90) {
      altitudeAngle = 0
  } else if (tiltX == 0) {
    altitudeAngle = Math.PI/2 - Math.abs(tiltYrad);
  } else if (tiltY == 0) {
    altitudeAngle = Math.PI/2 - Math.abs(tiltXrad);
  } else {
    // Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
    altitudeAngle =  Math.atan(1.0/Math.sqrt(Math.pow(Math.tan(tiltXrad),2) + Math.pow(Math.tan(tiltYrad),2)));
  }

  return {"altitudeAngle":altitudeAngle, "azimuthAngle":azimuthAngle};
}

event、eventType、eventTarget、bubbles、および cancelable を用いて PointerEvent を初期化するには、次の手順を実行する：

1. MouseEvent を初期化する を、event、eventType、eventTarget、bubbles、および cancelable を用いて実行する。
2. それ以外のすべての属性を、既定の PointerEvent 値に初期化する。

eventType と eventTarget、bubbles、および cancelable を用いて PointerEvent を作成するには、次の手順を実行する：

1. event を、event を作成する を PointerEvent を用いて行った結果とする。
2. PointerEvent を初期化する を、event、eventType、eventTarget、bubbles、および cancelable を用いて実行する。
3. event を返す

1. eventType を、イベント種別を含む DOMString とする
2. mouseevent を、対応する MouseEvent とする
3. event を、event を作成する を PointerEvent を用いて行った結果とする
4. target を、mouseevent.target とする
5. PointerEvent を初期化する を、event、eventType、および target を用いて実行する
6. MouseEvent 属性を mouseevent から event にコピーする
7. event を返す

1. mouseout を、対応する mouseout MouseEvent とする
2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
   Editor's note

   Can this send pointermove and pointerrawupdate? Or do we need 2 methods?

   Editor's note

   What is needed to properly define how pointermove events are coalesced?

2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
   注記

   mousedown イベントとは異なり、pointerdown イベントは、複数ボタンが押下されたときにネストされない。 フィールドを PointerEvent にコピーできるよう、この MouseEvent が渡される。

2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
2. target を、mouseout.target とする
3. dispatch pointerout を target に対して行う

1. mouseout を、対応する mouseout MouseEvent とする
   注記

   mouseup イベントとは異なり、pointerup イベントは、複数ボタンが押下されたときにネストされない。フィールドを PointerEvent にコピーできるよう、この MouseEvent が渡される。

2. pointerout を、MouseEvent から PointerEvent を作成する を "pointerout" と mouseout で実行した結果とする
3. pointerevent 属性を設定する
   Editor's note

   TODO.

4. target を、mouseout.target とする
5. dispatch pointerout を target に対して行う

user agent は、次のいずれかが起こったとき、pointer event を発火して pointerover という名前のイベントを発火しなければならない（MUST）：

• ポインタのターゲットを 決定する手順が、ポインタが要素へ移動したことを検出した。
• レイアウト変更により、静止したポインティングデバイスの capture されていないポインタの下に、要素の hit test 境界が移動した。
• user agent が、ホバーをサポートしないデバイスに対して pointerdown イベントを発火する前（pointerdown 参照）。

user agent は、次のいずれかが起こったとき、pointer event を発火して pointerenter という名前のイベントを発火しなければならない（MUST）：

• ポインタのターゲットを 決定する手順が、ポインタが要素またはその子孫へ移動したことを検出した。
• レイアウト変更により、静止したポインティングデバイスの capture されていないポインタの下に、要素またはその子孫の hit test 境界が移動した。
• user agent が、ホバーをサポートしないデバイスに対して pointerdown イベントを発火する前（pointerdown 参照）。

user agent は、ポインタが active buttons state に入ったとき、pointer event を発火して pointerdown という名前のイベントを発火しなければならない（MUST）。マウスでは、デバイスがボタン未押下の状態から少なくとも1つのボタンが押下された状態へ移行したときである。タッチでは、digitizer に物理的接触が行われたときである。ペンでは、ボタン未押下のままデジタイザに物理的接触する場合、またはホバー中にボタン未押下の状態から少なくとも1つのボタンが押下された状態へ移行する場合である。

入力 ホバーをサポートしないデバイスについては、user agent は、pointerdown イベントをディスパッチする前に、pointer event を発火して pointerover という名前のイベントを発火し、その後に pointerenter という名前の pointer event を発火しなければならない（MUST）。

user agent は、ポインタが pointerdown または pointerup イベントを発火しない任意のプロパティを変更したとき、pointer event を発火して pointermove という名前のイベントを発火しなければならない（MUST）。これには、座標、圧力、接線圧（tangential pressure）、 tilt、twist、接触ジオメトリ（width および height）、または chorded buttons の変更が含まれる。

user agent は、（例えば性能上の理由から）pointermove イベントのディスパッチを遅延してもよい（MAY）。 coalesced events 情報は、ディスパッチされた単一の pointermove イベントに対するgetCoalescedEvents メソッドを通じて公開される。 イベントのターゲットを見つけるには、この種のイベントの最終座標を使用すべきである。

user agent は、ポインタが pointerdown または pointerup イベントを発火しない任意のプロパティを変更したとき、pointer event を発火して pointerrawupdate という名前のイベントを発火しなければならない（MUST）。また、これは secure context 内でのみ行わなければならない。該当するプロパティの一覧は pointermove イベントを参照。

pointermove とは対照的に、user agent は pointerrawupdate イベントを、可能な限り速やかに、かつ JavaScript がイベントを処理できる頻度でディスパッチすべきである（SHOULD）。

pointerrawupdate イベントの target は、pointermove イベントと異なる場合がある。これは、pointermove イベントが遅延または coalesce される可能性があり、ターゲット検出に用いられるイベントの最終位置が、その coalesced events と異なりうるためである。

すでに同一の pointerId を持ち、かつ event loop 内で未ディスパッチの別の pointerrawupdate がすでに存在する場合、user agent は、新しい pointerrawupdate を新しい task を作成する代わりに、そのイベントと coalesce してもよい（MAY）。 これにより、pointerrawupdate が coalesced events を持ちうるようになり、 それらはイベントが event loop で処理され次第、単一の pointerrawupdate イベントの coalesced events としてすべて配信される。 詳しくはgetCoalescedEvents を参照。

pointerrawupdate と pointermove の順序について、プラットフォームからの更新により pointerrawupdate と pointermove の両方のイベントが発生する場合、user agent は、対応する pointermove の前に pointerrawupdate イベントをディスパッチしなければならない（MUST）。

target を除けば、直前の pointermove イベント以降にディスパッチされたすべての pointerrawupdate イベントの coalesced events リストを連結したものは、次の pointermove イベントの coalesced events と、その他のイベント属性の点で同一である。 pointerrawupdate の属性は、例外として cancelable があり、これは pointerrawupdate では false でなければならない（MUST）。それ以外は、概ね pointermove と同じである。

user agent は、compatibility mouse events を pointerrawupdate に対して発火しないべきである（SHOULD）。

user agent は、ポインタが active buttons state から離れたとき、pointer event を発火して pointerup という名前のイベントを発火しなければならない（MUST）。マウスでは、デバイスが少なくとも1つのボタンが押下された状態からボタン未押下の状態へ移行したときである。タッチでは、digitizer から物理的接触が取り除かれたときである。ペンでは、ボタン未押下のままデジタイザへの物理的接触が取り除かれたとき、またはホバー中に少なくとも1つのボタンが押下された状態からボタン未押下の状態へ移行したときである。

入力 ホバーをサポートしないデバイスについては、user agent は、pointerup イベントをディスパッチした後に、pointer event を発火して pointerout という名前のイベントを発火し、その後に pointerleave という名前の pointer event を発火しなければならない（MUST）。

すべての pointerup イベントは、pressure の値が 0 である。

user agent は、ポインタが現在 capture されている場合、暗黙に pointer capture を解放もしなければならない（MUST）。

user agent は、pointer event ストリームを抑止するシナリオを検出したとき、pointer event を発火して pointercancel という名前のイベントを発火しなければならない（MUST）。

pointercancel イベントの次のプロパティの値は、同一の pointerId を持つ最後にディスパッチされた pointer event の値と一致しなければならない（MUST）：width、 height、pressure、tangentialPressure、tiltX、 tiltY、twist、altitudeAngle、azimuthAngle、 pointerType、isPrimary、および [UIEVENTS] から継承された座標。pointercancel イベントにおける coalescedEvents および predictedEvents リストは空でなければならず（MUST）、イベントの cancelable 属性は false でなければならない（MUST）。

user agent は、次のいずれかが起こったとき、pointer event を発火して pointerout という名前のイベントを発火しなければならない（MUST）：

• ポインタのターゲットを 決定する手順が、ポインタが要素の外へ移動したことを検出した。
• レイアウト変更により、静止したポインティングデバイスの capture されていないポインタの下から、要素の hit test 境界が離れるように移動した。
• user agent が、pointerup イベントを、ホバーをサポートしない デバイスに対して発火した後（pointerup を参照）。
• user agent が、pointer event ストリームを抑止するシナリオを検出した。

user agent は、次のいずれかが起こったとき、pointer event を発火して pointerleave という名前のイベントを発火しなければならない（MUST）。

• ポインタのターゲットを 決定する手順が、ポインタが要素およびそのすべての子孫の外へ移動したことを検出した。
• レイアウト変更により、静止したポインティングデバイスの capture されていないポインタの下から、要素およびそのすべての子孫の hit test 境界が離れるように移動した。
• user agent が、pointerup イベントを、ホバーをサポートしない デバイスに対して発火した後（pointerup を参照）。
• user agent が、pointer event ストリームを抑止するシナリオを検出した。

user agent は、要素が pointer capture を受け取ったとき、pointer event を発火して gotpointercapture という名前のイベントを発火しなければならない（MUST）。このイベントは pointer capture を受け取る要素に対して発火される。そのポインタに対する後続のイベントは、この要素で発火される。pointer capture を設定する節および 保留中の pointer capture を処理する節を参照。

user agent は、ポインタについて pointer capture が解放された後に、pointer event を発火して lostpointercapture という名前のイベントを発火しなければならない（MUST）。このイベントは、capture が解放された後のポインタに対する後続イベントのいずれよりも先に発火されなければならない（MUST）。このイベントは、pointer capture が取り除かれた要素に対して発火される。click, auxclick, および contextmenu イベント を除く、そのポインタに対する後続のすべてのイベントは、イベントターゲットを決定するために通常の hit testing 機構（この仕様のスコープ外）に従う。pointer capture を解放する節、pointer capture の暗黙の解放節、および 保留中の pointer capture を処理する節を参照。

この節は、[UIEVENTS] で定義される click、 auxclick および contextmenu イベントへの追加である。これらのイベントは通常、ユーザーインターフェイスのアクティベーションに結び付けられており、キーボードのような非ポインタ入力デバイスからでも発火される。

これらのイベントは PointerEvent 型でなければならず（MUST）、この節の残りで述べる追加要件の対象となる。

WebIDL[Exposed=Window]
interface WheelEvent : MouseEvent {
	constructor(DOMString type, optional WheelEventInit eventInitDict = {});
	// DeltaModeCode
	const unsigned long DOM_DELTA_PIXEL = 0x00;
	const unsigned long DOM_DELTA_LINE	= 0x01;
	const unsigned long DOM_DELTA_PAGE	= 0x02;

	readonly attribute double deltaX;
	readonly attribute double deltaY;
	readonly attribute double deltaZ;
	readonly attribute unsigned long deltaMode;
};

DOM_DELTA_PIXEL

delta の測定単位はピクセルでなければならない（MUST）。 これはほとんどのオペレーティングシステムおよび 実装構成における最も典型的なケースである。

DOM_DELTA_LINE

delta の測定単位は個々のテキスト行でなければならない（MUST）。 これは多くのフォームコントロールにおけるケースである。

DOM_DELTA_PAGE

delta の測定単位はページでなければならない（MUST）。 ページは単一の画面として、または区切られたページとして定義される。

deltaX

wheel イベントの既定動作がスクロールである user agent では、このイベントがキャンセルされない場合にスクロールされるべき x 軸方向の測定値（ピクセル、行、またはページ）が値でなければならない（MUST）。 それ以外の場合、これは x 軸まわりのホイールデバイスの動きを表す、実装固有の測定値 （ピクセル、行、またはページ）である。 この属性の un-initialized value は 0.0 でなければならない（MUST）。

deltaY

wheel イベントの既定動作がスクロールである user agent では、このイベントがキャンセルされない場合にスクロールされるべき y 軸方向の測定値（ピクセル、行、またはページ）が値でなければならない（MUST）。 それ以外の場合、これは y 軸まわりのホイールデバイスの動きを表す、実装固有の測定値 （ピクセル、行、またはページ）である。 この属性の un-initialized value は 0.0 でなければならない（MUST）。

deltaZ

wheel イベントの既定動作がスクロールである user agent では、このイベントがキャンセルされない場合にスクロールされるべき z 軸方向の測定値（ピクセル、行、またはページ）が値でなければならない（MUST）。 それ以外の場合、これは z 軸まわりのホイールデバイスの動きを表す、実装固有の測定値 （ピクセル、行、またはページ）である。 この属性の un-initialized value は 0.0 でなければならない（MUST）。

deltaMode

deltaMode 属性は、 delta 値に対する測定単位の指示を含む。既定値は DOM_DELTA_PIXEL（ピクセル）である。 この属性は、delta 値の測定単位を示すために、 DOM_DELTA 定数のいずれかに設定されなければならない（MUST）。 正確な測定値は、デバイス、オペレーティングシステム、 およびアプリケーション構成に固有である。 この属性の un-initialized value は 0 でなければならない（MUST）。

WebIDLdictionary WheelEventInit : MouseEventInit {
	double deltaX = 0.0;
	double deltaY = 0.0;
	double deltaZ = 0.0;
	unsigned long deltaMode = 0;
};

deltaX

deltaZ 属性を参照。

deltaY

deltaZ 属性を参照。

deltaZ

deltaZ 属性を WheelEvent オブジェクト上で初期化する。 この属性（および deltaX と deltaY 属性）に対する相対的な正の値は、 X、Y、Z 軸がそれぞれ文書の右端、下端、 最も遠い奥行き（ユーザーから遠ざかる方向）へ向く 右手座標系によって与えられる。相対的な負の値は、それぞれ 反対方向である。

deltaMode

deltaMode 属性を、 WheelEvent オブジェクト上で、列挙値 0、1、2 に初期化する。これらは、ホイールの 回転 がスクロールを引き起こしたであろう場合に、スクロールされたピクセル量 （DOM_DELTA_PIXEL）、スクロールされた行数 （DOM_DELTA_LINE）、またはスクロールされたページ数 （DOM_DELTA_PAGE）を表す。

ホイールイベントに対して preventDefault を呼び出すと、スクロールを防止したり、 あるいは中断したりできる。最大のスクロール性能を得るため、user agent は、スクロールに関連付けられた各ホイールイベントがキャンセルされるかどうかを見るために、 それらが処理されるのを待たない場合がある。そのような場合、user agent は cancelable プロパティが false の wheel イベントを生成すべきである（SHOULD）。これは、 preventDefault を用いてスクロールを防止または中断できないことを示す。そうでなければ cancelable は true になる。

特に、user agent は、このイベントに対して non-passive リスナーが存在しないことを観測したとき、 キャンセル不可能な wheel イベントのみを生成すべきである（SHOULD）。