ポインターイベント

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

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

この属性の 未初期化値 は 0 で MUST です。

screenY

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

この属性の 未初期化値 は 0 で MUST です。

clientX

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

この属性の 未初期化値 は 0 で MUST です。

clientY

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

この属性の 未初期化値 は 0 で MUST です。

layerX

祖先要素のうち最も近いもので、 スタッキングコンテキストであるか、位置指定されているか、または スタッキングコンテキストを 描画するときに位置指定フェーズで描画される要素からの水平オフセット。

この属性の 未初期化値 は 0 で MUST です。

layerY

祖先要素のうち最も近いもので、 スタッキングコンテキストであるか、位置指定されているか、または スタッキングコンテキストを 描画するときに位置指定フェーズで描画される要素からの垂直オフセット。

この属性の 未初期化値 は 0 で MUST です。

ctrlKey

KeyboardEvent の ctrlKey 属性を参照してください。

この属性の 未初期化値 は false で MUST です。

shiftKey

KeyboardEvent の shiftKey 属性を参照してください。

この属性の 未初期化値 は false で MUST です。

altKey

KeyboardEvent の altKey 属性を参照してください。

この属性の 未初期化値 は false で MUST です。

metaKey

KeyboardEvent の metaKey 属性を参照してください。

この属性の 未初期化値 は false で MUST です。

button

マウスボタンの押下または解放によって発生したマウスイベント中、button は、どのポインティングデバイスボタンの状態が変化したかを示すために 使用される MUST です。

button 属性の値は次のとおりである MUST です:

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

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

注記

button の値は、マウスボタンの押下/解放によって発生していないイベントでは 更新されません。このようなシナリオでは、値 0 を左ボタンとしてではなく、既定値として解釈するよう 注意してください。

注記

mousedown や mouseup などのイベントに関連する一部の 既定の動作 は、使用されている特定のマウス ボタンに依存します。

この属性の 未初期化値 は 0 で MUST です。

buttons

任意のマウスイベント中、buttons は、 現在押されているマウスボタンの組み合わせをビットマスクとして表すために使用される MUST です。

注記

名前は似ていますが、buttons 属性と button 属性の値は非常に 異なります。button の値は、 mousedown / mouseup イベントハンドラー中に有効であると想定される一方、 buttons 属性は、任意の信頼された MouseEvent オブジェクト（配送中）について、 マウスのボタンの状態を反映します。これは「現在アクティブなボタンがない」状態（0）を表せるためです。

buttons 属性の値は次のとおりである MUST です:

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

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

注記

任意のボタン値集合の合計は一意の数値であるため、コンテンツ作者はビット演算を使用して、 デバイス上の任意の数のマウスボタンについて、現在いくつのボタンが押されており、それがどのボタンであるかを判定できます。たとえば、 値 3 は左ボタンと右ボタンが現在どちらも押されていることを示し、値 5 は左ボタンと中央ボタンが 現在どちらも押されていることを示します。

注記

mousedown や mouseup などのイベントに関連する一部の 既定の動作 は、使用されている特定のマウス ボタンに依存します。

この属性の 未初期化値 は 0 で MUST です。

relatedTarget

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

この属性の 未初期化値 は null で MUST です。

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 属性を、ユーザーのスクリーン上のマウスポインターの望ましい 水平方向の相対位置に初期化します。

イベントオブジェクトを指定されたマウス位置に初期化しても、ユーザーのマウス ポインターを初期化された位置へ移動してはなりません。

screenY

screenY 属性を、ユーザーのスクリーン上のマウスポインターの望ましい垂直方向の 相対位置に初期化します。

イベントオブジェクトを指定されたマウス位置に初期化しても、ユーザーのマウス ポインターを初期化された位置へ移動してはなりません。

clientX

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

イベントオブジェクトを指定されたマウス位置に初期化しても、ユーザーのマウス ポインターを初期化された位置へ移動してはなりません。

clientY

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

イベントオブジェクトを指定されたマウス位置に初期化しても、ユーザーのマウス ポインターを初期化された位置へ移動してはなりません。

button

button 属性を、マウスのボタンの望ましい状態を表す数値に 初期化します。

注記

値 0 は主マウスボタンを表すために使用され、1 は補助/中央マウスボタンを表すために使用され、2 は右マウスボタンを表すために使用されます。 2 より大きい数値も可能ですが、この文書では指定されていません。

buttons

buttons 属性を、アクティブとみなされるマウスのボタンの 1 つまたは複数を表す数値に初期化します。

注記

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

JavaScript では、右ボタン（2）と中央ボタン（4）が同時に押されているかのように buttons 属性を初期化するには、buttons 値を次のいずれかとして割り当てることができます:

{ buttons: 2 | 4 }

または:

{ buttons: 6 }

relatedTarget

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

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

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

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

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

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

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

MouseEvent、または以下のアルゴリズムを使用してこれらのオブジェクトから派生したオブジェクトを 構築する目的では、すべての MouseEvent および派生 オブジェクトは、Modifier Keys table [UIEvents-Key] に記述されている キー修飾子名を使用して設定および取得できる 内部キー修飾子状態を持ちます。

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

• 構築中の Event が MouseEvent オブジェクト、またはそれから派生するオブジェクトであり、かつ EventModifierInit 引数がコンストラクターに提供された場合、次のサブ手順を実行します:
  • 各 EventModifierInit 引数について、辞書メンバーが文字列 "modifier" で始まる場合、キー修飾子名を、 接頭辞 "modifier" を除いた辞書メンバーの名前とし、対応する値に一致する Event オブジェクトの 内部キー 修飾子状態を設定します。

MouseEvent は、さまざまな修飾キーの状態を追跡するために使用される次の内部フラグを持ちます: shift フラグ、 control フラグ、 alt フラグ、 altgraph フラグ、 および meta フラグ。 これらのフラグは、マウスイベント時に対応する修飾キーが押されていた場合に設定されます。

1. pos を、ビューポートに対する x,y 座標とします
2. [CSSOM-View] の elementFromPoint() に pos を渡したもの（pos にある最前面の DOM 要素）を返します
   注記

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

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

1. UIEvent を初期化するを、event、eventType、eventTarget、 bubbles および cancelable で実行します。
2. event.screenX を、デスクトップの原点に対して イベントが発生した位置の x 座標に設定します
3. event.screenY を、デスクトップの原点に対して イベントが発生した位置の y 座標に設定します
4. event.clientX を、ビューポートの原点に対してイベントが発生した位置の x 座標に設定します
5. event.clientY を、ビューポートの原点に対してイベントが発生した位置の y 座標に設定します
6. マウスイベント修飾子を設定するを event で実行します
7. event.button を 0 に設定します
8. event.buttons を マウスボタンビットマスクに設定します
9. MouseEvent の PointerLock 属性を初期化するを event で実行します
   Issue 1

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

1. event を、更新する MouseEvent とします
2. キー修飾子状態が "Shift" を含む場合は event の shift フラグを設定し、それ以外の場合は設定解除します
3. キー修飾子状態が "Control" を含む場合は event の control フラグを設定し、それ以外の場合は設定解除します
4. キー修飾子状態が "Alt" を含む場合は event の alt フラグを設定し、それ以外の場合は設定解除します
5. キー修飾子状態が "AltGraph" を含む場合は event の altgraph フラグを設定し、それ以外の場合は設定解除します
6. キー修飾子状態が "Meta" を含む場合は event の meta フラグを設定し、それ以外の場合は設定解除します
7. イベントの shift フラグが設定されている場合は event.shiftKey を true に、そうでない場合は false に設定します
8. イベントの control フラグが設定されている場合は event.ctrlKey を true に、そうでない場合は false に設定します
9. イベントの alt フラグまたは altgraph フラグが設定されている場合は event.altKey を true に、そうでない場合は false に設定します
10. イベントの meta フラグが設定されている場合は event.metaKey を true に、そうでない場合は false に設定します

1. eventType を、有効な MouseEvent 型を含む DOMString とします
2. eventTarget を、イベントの EventTarget とします
3. bubbles を true とします
4. cancelable を true とします
5. event を、MouseEvent を使用して イベントを作成する結果とします
6. MouseEvent を初期化するを event、eventType、eventTarget、bubbles および cancelable で実行します。
7. event を返します

1. eventType を、有効な MouseEvent 型を含む DOMString とします
2. eventTarget を、イベントの EventTarget とします
3. bubbles を "false" とします
4. cancelable を "false" とします
5. event を、MouseEvent を使用して イベントを作成する結果とします
6. MouseEvent を初期化するを event、eventType、eventTarget、bubbles および cancelable で実行します。
7. event を返します

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

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

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

   TODO。

3. event.type が [ mousedown, mouseup ] のいずれかである場合、
   1. mbutton を、どのマウスボタンが押されたかを識別する native からの ID とします
   2. event.button を、 mbutton を用いて MouseEvent button 属性を計算する結果に設定します

1. native をネイティブ mousedown とします
2. mbutton を、どのマウスボタンが押されたかを識別する native からの ID とします
3. マウスボタンビットマスクを次のように更新します:
   1. mbutton が主マウスボタンである場合、0x01 ビットを設定します
   2. mbutton が副マウスボタンである場合、0x02 ビットを設定します
   3. mbutton が補助（中央）マウスボタンである場合、0x04 ビットを設定します
      注記

      その他のボタンは 0x08 から追加できます。

4. target を、native からのビューポート相対座標を用いて ヒットテストしたものとします
5. event を、"mousedown" と target を用いて キャンセル可能な MouseEvent を作成する結果とします
6. ネイティブから MouseEvent 属性を 設定するを native で実行します
7. pointerdown イベントを送信するかもしれないを event で実行します
8. result を、event を target に dispatch した結果とします
9. result が true であり、target が click focusable な focusable area である場合、
   1. target で フォーカス手順を実行します
10. mbutton が副マウスボタンである場合、
    1. コンテキストメニューを表示するかもしれないを native、target で実行します

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

   mousedown と mouseup の間には、他のマウスイベントが発生することがあります。

2. mbutton を、どのマウスボタンが押されたかを識別する native からの ID とします
3. マウスボタンビットマスクを次のように更新します:
   1. mbutton が主マウスボタンである場合、0x01 ビットをクリアします
   2. mbutton が副マウスボタンである場合、0x02 ビットをクリアします
   3. mbutton が補助（中央）マウスボタンである場合、0x04 ビットをクリアします
4. target を、native からのビューポート相対座標を用いて ヒットテストしたものとします
5. event を、"mouseup" と target を用いて キャンセル可能な MouseEvent を作成する結果とします
6. ネイティブから MouseEvent 属性を 設定するを native で実行します
7. pointerup イベントを送信するかもしれないを event で実行します
8. event を target に dispatch します

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

   プラットフォームは、クリックを生成する mouseup に対して ネイティブ mouse up を処理する の直後にこれを呼び出すべきです。

2. target を、native からのビューポート相対座標を用いて ヒットテストしたものとします
3. click イベントを送信するを native および target で実行します。

1. native をネイティブ mousedown とします
2. target を、イベントの EventTarget とします
3. mbutton を 1（既定で主マウスボタン）とします
4. native が有効である場合、
   1. mbutton を、どのマウスボタンが押されたかを識別する native からの ID とします
5. mbutton が主マウスボタンである場合は eventType を "click" に、 それ以外の場合は "auxclick" に設定します
6. event を、eventType および target を用いて PointerEvent を作成する結果とします
7. native が有効である場合、
   1. ネイティブから MouseEvent 属性を設定するを event、native で実行します
   2. event.screenX が整数値でない場合、それを丸めます。
   3. event.screenY が整数値でない場合、それを丸めます。
8. event を target に dispatch します
   注記

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

   編集者注

   任意の「既定の動作」は、ターゲットの activation behavior アルゴリズムをトリガーすることにより、配送中に処理されます。そのため、ここでそれを処理する必要はありません。 ただし、既存の仕様が disabled/css-pointer-events/inert/... を処理していることを確認する必要があります。

   注記

   HTMLelement.click() を処理するには、native = null および target = HTMLelement でこのアルゴリズムを呼び出します。

   注記

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

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

   これは、double click を生成するマウスクリックについて、handle native mouse click の直後に呼び出されるべきです。

2. mbutton を、どのマウスボタンが押されたかを識別する native からの ID とします
3. mbutton が主マウスボタンでない場合、return します
4. target を、native からのビューポート相対座標を用いて ヒットテストしたものとします
5. event を、"dblclick" および target を用いて PointerEvent を作成する結果とします
6. ネイティブから MouseEvent 属性を設定するを event、native で実行します
7. event.screenX が整数値でない場合、 それを丸めます。
8. event.screenY が整数値でない場合、 それを丸めます。
9. event を target に dispatch します

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

   このアルゴリズムは、PointerEvents の dispatch について仮定を置いています。なぜなら、それらは 現在明示的に指定されていないためです。pointerevents/285 が 解決されたら、これは更新が必要になる可能性があります。

2. target を、native からのビューポート相対座標を用いて ヒットテストしたものとします
3. targetDomPath を、target の 包含祖先とします
4. 現在の要素を離れるためのイベントを生成します:
   1. 最後の mouse 要素が定義されており、かつ target と等しくない場合、
      1. mouseout を、"mouseout" と 最後の mouse 要素を用いて キャンセル可能な MouseEvent を作成する結果とします
         編集者注

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

   2. pointerout イベントを送信するかもしれないを mouseout で実行します
   3. mouseout を target に dispatch します
      注記

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

   4. leaveElements を、最後の mouse DOM パスのコピーから、targetDomPath と共通するすべての要素を削除したものとします。
   5. leaveElements 内の各 element について、次を実行します
      編集者注

      element が削除されている場合を処理します。 それが移動されている場合も同様です: DOM 変異は mouseleave イベントをトリガーすべきだったのでしょうか? 今それを送信すべきでしょうか? それとも破棄すべきでしょうか? 現在のブラウザーが何を行うかを検証する必要があります。

      1. mouseleave を、"mouseleave" と element を用いて キャンセル不能な MouseEvent を作成する結果とします
      2. mouseleave.Event.composed = false に設定します
         注記

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

      3. pointerleave イベントを送信するかもしれないを mouseleave で実行します
      4. result を、mouseleave を element に dispatch した結果とします
5. 新しい要素に入るためのイベントを生成します:
   1. target が 最後の mouse 要素でない場合、 次を実行します
      1. mouseover を、"mouseover" と target を用いて キャンセル可能な MouseEvent を作成する結果とします
         編集者注

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

      2. pointerover イベントを送信するかもしれないを mouseover で実行します
      3. mouseout を target に dispatch します
         注記

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

      4. enterElements を、targetDomPath のコピーから 最後の mouse DOM パスと共通するすべての要素を削除したものとします。
      5. enterElements 内の各 element について、次を実行します
         注記

         element が削除または移動されている場合を処理します。

         1. mouseenter を、"mouseenter" と element を用いて キャンセル不能な MouseEvent を作成する結果とします
         2. mouseenter.Event.composed = false に設定します
            注記

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

         3. pointerenter イベントを送信するかもしれないを mouseenter で実行します
            注記

            shadow DOM 要素について互換性を確認します。Chrome/Linux はこの イベントを要素と shadow root の両方で発火します。

         4. result を、mouseenter を element に dispatch した結果とします
      6. 最後の mouse 要素を target に設定します
      7. 最後の mouse DOM パスを targetDomPath に設定します
6. mousemove を、"mousemove" と element を用いて キャンセル可能な MouseEvent を作成する結果とします
7. mousemove の PointerLock 属性を設定する
8. pointermove イベントを送信するかもしれないを mousemove で実行します
9. mousemove を element に dispatch します

1. native をネイティブ mousedown または pointer イベントとします
2. target をイベントの EventTarget とします
   1. menuevent を、"contextmenu"、target を用いて PointerEvent を作成する結果とします
   2. native が有効である場合、次を実行します
      1. ネイティブから MouseEvent 属性を設定するを native で実行します
   3. result を、menuevent を target に dispatch した結果とします
   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 イベント型の 既定の動作は、 イベントの ターゲット、 および button または buttons 属性の値に基づいて異なります。 auxclick イベント型の典型的な 既定の動作は次のとおりです:

• ターゲットに 関連付けられたアクティベーション動作がある場合、 既定の 動作は、そのアクティベーション 動作を実行することでなければなりません MUST。

myLink.addEventListener("auxclick", function(e) {
  if (e.button === 1) {
    // これは、たとえばリンクを中央クリックしたときに
    // 新しいタブを開く既定の挙動を防止します。
    e.preventDefault();
    // アプリに合う方法で、リンクまたは非リンクボタンを新しいタブで開く処理など、
    // 中央ボタンクリックを処理するための別の処理を行います。
    // タブストリップでタブを閉じるなど、click アクションで行うべき
    // その他のアクションもここで行えます。
  }
});

myDiv.addEventListener("contextmenu", function(e) {
  // この呼び出しにより、コンテキストメニューが表示されて
  // ページがイベントを受信する妨げにならないようにします。
  e.preventDefault();
});
myDiv.addEventListener("auxclick", function(e) {
  if (e.button === 2) {
    // アプリ内でカスタマイズされたコンテキストメニューを開くなど、
    // 右ボタンクリックを処理するための別の処理を行います。
  }
});

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 イベントをなおトリガーします（それが click の通常の時間的 ヒステリシス内に収まる場合）。 ユーザーエージェントによって生成される mouse events はテキストノード上では配送されないことに注意してください。

ポインターデバイスに関連付けられることに加えて、 click イベント型は、要素の アクティベーションの一部として配送されなければなりません MUST。

click イベント型の 既定の動作は、 イベントの ターゲット、 および button または buttons 属性の値に基づいて異なります。 click イベント型の典型的な 既定の動作は次のとおりです:

• ターゲットに 関連付けられたアクティベーション動作がある場合、 既定の 動作は、そのアクティベーション 動作を実行することでなければなりません MUST。
• ターゲットが フォーカス可能である場合、既定の 動作は、その要素に文書フォーカスを与えることでなければなりません MUST。

ユーザーエージェントは、 コンテキストメニューを呼び出す前にこのイベントを配送しなければなりません MUST。

contextmenu イベントが右マウス ボタンによってトリガーされる場合、 contextmenu イベントは、mousedown イベントの後に配送されなければなりません MUST。

ユーザーエージェントは、 ポインティングデバイスの主ボタンが要素上で 2 回クリックされたときに、このイベントを配送しなければなりません MUST。ダブルクリックの 定義は環境設定に依存します。ただし、イベントターゲットは mousedown、mouseup、および dblclick の間で同じでなければなりません MUST。click と double click が同時に発生する場合、このイベント 型はイベント型 click の後に配送されなければならず MUST、そうでない場合はイベント型 mouseup の後に配送されなければなりません。

click イベントと同様に、dblclick イベントは 主ポインターボタンに対してのみ発火されるべきです。副ボタンは dblclick イベントを発火してはなりません MUST NOT。

マルチポインター（例: マルチタッチ）のシナリオでは、isPrimary プロパティは、各ポインター型について アクティブポインターの集合の中から マスターポインターを識別するために使用されます。

• 任意の時点で、各ポインター型についてプライマリポインターは最大 1 つだけ存在できます。
• 特定のポインター型について最初にアクティブになったポインター（例: マルチタッチ操作で最初にスクリーンに触れた指）は、 そのポインター型のプライマリポインターになります。
• プライマリポインターのみが 互換性マウスイベントを生成します。 複数の プライマリポインターが存在する場合、それらのポインターはすべて 互換性マウスイベントを生成します。

e という名前の ポインターイベントを発火するとは、 イベントを発火することを意味します。 そのイベントは e という名前で、 属性が PointerEvent Interface および 属性と既定の動作で定義されるように設定された PointerEvent を使用します。

イベントが gotpointercapture、lostpointercapture、click、 auxclick、または contextmenu イベントでない場合、この PointerEvent について 保留中のポインターキャプチャを処理する手順を実行します。

イベントが発火される ターゲットを決定する方法は次のとおりです:

• そのポインターについて ポインターキャプチャターゲットオーバーライドが 設定されている場合、ターゲットを ポインターキャプチャターゲットオーバーライド オブジェクトに設定します。
• そうでない場合、ターゲットを ヒットテストによって返されるオブジェクトに設定します。

targetDocument を、ターゲットの ノード文書 [DOM] とします。

イベントが pointerdown、pointermove、または pointerup の場合、イベントの pointerId について アクティブ文書を targetDocument に設定します。

イベントが pointerdown であり、関連付けられた デバイスが直接操作デバイスであり、ターゲットが Element である場合、 暗黙的ポインターキャプチャで説明されるように、この pointerId について、ターゲット要素へ ポインターキャプチャを設定する。

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

決定されたターゲットにイベントを発火します。

決定されたターゲットを、指定されたポインターの previousTarget として保存し、 needsOverEvent フラグを false にリセットします。 任意の時点で previousTarget がもはや 接続済み [DOM] でなくなる場合、 previousTarget を、previousTarget へイベントを dispatch することに対応するイベントパスに従う、 最も近いまだ 接続済み [DOM] の親へ更新し、 needsOverEvent フラグを true に設定します。

スクリーン表面に対して相対的に移動した、またはいずれかのプロパティに何らかの変化があったポインティングデバイスは、 Pointer Event 型で定義されるさまざまなイベントを発火します。 静止しているポインティングデバイス（スクリーン表面に対して相対的に移動せず、いかなるプロパティにも変化がなかったもの）については、 ユーザーエージェントは、ポインターの ヒットテストターゲットに影響する レイアウト変更の後で、特定の境界イベントを発火しなければなりません MUST。 詳細については pointerover、pointerenter、pointerout および pointerleave を参照してください。 ユーザーエージェントは、 パフォーマンス上の理由（例: 境界イベントリスナーによって引き起こされる過剰なヒットテストやレイアウト変更を避けるため）により、 これらの境界イベントの発火を遅延させてもよい MAY です。

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

具体的なハードウェアおよびプラットフォームによっては、ユーザーエージェントはスクリーン平面に対する トランスデューサーの向きについて、おそらく 1 つの値集合だけを受け取ります — tiltX / tiltY または altitudeAngle / azimuthAngle のいずれかです。 ユーザーエージェントは、これらの値を変換するために次のアルゴリズムを使用しなければなりません MUST。

ユーザーエージェントが azimuthAngle / altitudeAngle から tiltX / tiltY を計算するときは、最終的な整数値を Math.round [ECMASCRIPT] の規則を使用して丸めるべきです SHOULD。

/* tiltX/tiltY と altitudeAngle/azimuthAngle の間の変換 */

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

  let tiltXrad = 0;
  let tiltYrad = 0;

  if (altitudeAngle == 0) {
    // pen は X-Y 平面内にある
    if (azimuthAngle == 0 || azimuthAngle == 2*Math.PI) {
      // pen は正の X 軸上にある
      tiltXrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI/2) {
      // pen は正の Y 軸上にある
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI) {
      // pen は負の X 軸上にある
      tiltXrad = -Math.PI/2;
    }
    if (azimuthAngle == 3*Math.PI/2) {
      // pen は負の Y 軸上にある
      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;

  // 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) {
    // azimuth を計算するための情報が不足している
    azimuthAngle = 0;
  } else {
    // 非境界ケース: tiltX も tiltY も 0 または +-90 と等しくない
    const tanX = Math.tan(tiltXrad);
    const tanY = Math.tan(tiltYrad);

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

  // 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 {
    // 非境界ケース: tiltX も tiltY も 0 または +-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. event、eventType、eventTarget、bubbles、および cancelable を用いて MouseEvent を初期化する
2. その他すべての属性を、既定の PointerEvent 値へ初期化します。

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

1. event を、 イベントを作成することを PointerEvent を用いて行った結果とします
2. event、eventType、eventTarget、bubbles、および cancelable を用いて PointerEvent を初期化する
3. event を返します

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

1. mouseout を、対応する mouseout MouseEvent とします
2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

1. mouseout を、対応する mouseout MouseEvent とします
2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

1. mouseout を、対応する mouseout MouseEvent とします
2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

1. mouseout を、対応する mouseout MouseEvent とします
2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

1. mouseout を、対応する mouseout MouseEvent とします
   編集者注

   これは pointermove と pointerrawupdate を送信できますか? それとも 2 つのメソッドが必要ですか?

   編集者注

   pointermove イベントがどのように合成されるかを適切に定義するには何が必要ですか?

2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

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

   mousedown イベントとは異なり、pointerdown イベントは、複数のボタンが押されてもネストされません。 MouseEvent は、 フィールドを PointerEvent へコピーできるように渡されます。

2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

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

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

   mouseup イベントとは異なり、pointerup イベントは、複数の ボタンが押されてもネストされません。MouseEvent は、 フィールドを PointerEvent へコピーできるように渡されます。

2. pointerout を、"pointerout" および mouseout を用いて MouseEvent から PointerEvent を作成する結果とします
3. pointerevent 属性を設定します
   編集者注

   TODO。

4. target を mouseout.target とします
5. pointerout を target に dispatch します

ユーザーエージェントは、 次のいずれかが発生したとき、ポインターイベントを発火することにより、 pointerover という名前のイベントを発火しなければなりません MUST:

• ポインターのターゲットを決定する手順が、 ポインターが要素内へ移動したことを検出した場合。
• レイアウト変更により、要素のヒットテスト境界が、静止しているポインティングデバイスの キャプチャされていないポインターの下へ移動した場合。
• ユーザーエージェントが、ホバーをサポートしないデバイスについて pointerdown イベントを発火する前 （pointerdown を参照）。

ユーザーエージェントは、 次のいずれかが発生したとき、ポインターイベントを発火することにより、 pointerenter という名前のイベントを発火しなければなりません MUST:

• ポインターのターゲットを決定する手順が、 ポインターが要素またはその子孫の 1 つの中へ移動したことを検出した場合。
• レイアウト変更により、要素またはその子孫の 1 つの ヒットテスト境界が、静止しているポインティングデバイスの キャプチャされていないポインターの下へ移動した場合。
• ユーザーエージェントが、ホバーをサポートしないデバイスについて pointerdown イベントを発火する前 （pointerdown を参照）。

ユーザーエージェントは、 ポインターがアクティブボタン状態に入ったとき、 ポインターイベントを発火することにより、 pointerdown という名前のイベントを発火しなければなりません MUST。mouse の場合、これはデバイスがボタン未押下状態から 少なくとも 1 つのボタン押下状態へ遷移したときです。touch の場合、これはデジタイザーに物理的な接触が行われたときです。 pen の場合、これはボタンが押されていない状態で pen がデジタイザーに物理的に接触したとき、または ホバー中にボタン未押下状態から少なくとも 1 つのボタン押下状態へ遷移したときです。

ホバーをサポートしないデバイスでの入力については、 ユーザーエージェントは、 pointerdown イベントを dispatch する前に、ポインターイベントを発火することにより、 pointerover という名前のイベントに続けて、 pointerenter という名前の ポインターイベントも発火しなければなりません MUST。

ユーザーエージェントは、 ポインターが、pointerdown または pointerup イベントを発火しないプロパティを 変更したとき、ポインターイベントを発火することにより、 pointermove という名前のイベントを発火しなければなりません MUST。これには、座標、圧力、接線方向圧力、 傾き、twist、接触ジオメトリ（width および height）、または コード化ボタンの任意の変更が含まれます。

ユーザーエージェントは、pointermove イベントの dispatch を （たとえば、パフォーマンス上の理由で）遅延させてもよい MAY です。 合成イベント情報は、単一の dispatch された pointermove イベントについて、 getCoalescedEvents メソッドを通じて公開されます。 そのようなイベントの最終座標は、イベントのターゲットを見つけるために使用されるべきです。

ユーザーエージェントは、 ポインターが pointerdown または pointerup イベントを発火しないプロパティを変更したとき、 ポインターイベントを発火することにより、 pointerrawupdate という名前のイベントを、 セキュアコンテキスト内でのみ 発火しなければなりません MUST。そのようなプロパティの一覧については pointermove イベントを参照してください。

pointermove とは対照的に、 ユーザーエージェントは pointerrawupdate イベントをできるだけ早く、 かつ JavaScript がそのイベントを処理できる頻度で dispatch すべきです SHOULD。

pointerrawupdate イベントの target は、 pointermove イベントのものと異なる場合があります。 これは、pointermove イベントが 遅延または合成される場合があり、target を見つけるために使用されるイベントの最終位置が、 その合成イベントの位置と異なる可能性があるためです。

同じ pointerId を持つ別の pointerrawupdate がすでに存在し、それが イベントループで まだ dispatch されていない場合、ユーザーエージェントは、 新しい pointerrawupdate について新しい タスクを作成する代わりに、 そのイベントと合成してもよい MAY ことに注意してください。 これにより、pointerrawupdate が 合成イベントを持つことがあり、それらはすべて、イベントが イベントループで処理され次第、 1 つの pointerrawupdate イベントの 合成イベントとして配信されます。 詳細については getCoalescedEvents を参照してください。

pointerrawupdate と pointermove の順序については、 ユーザーエージェントが、pointerrawupdate と pointermove の両方のイベントを引き起こす更新を プラットフォームから受け取った場合、ユーザーエージェントは、 対応する pointermove より前に pointerrawupdate イベントを dispatch しなければなりません MUST。

target を除き、最後の pointermove イベント以降に dispatch されたすべての pointerrawupdate イベントの合成イベントリストの連結は、 他のイベント属性に関して、次の pointermove イベントの合成イベントと同じです。 pointerrawupdate の属性は、 cancelable を除き、ほぼ pointermove と同じです。 cancelable は pointerrawupdate については false でなければなりません MUST。

ユーザーエージェントは、互換性マウスイベントを pointerrawupdate について発火すべきではありません SHOULD。

ユーザーエージェントは、 ポインターがアクティブボタン状態を離れたとき、 ポインターイベントを発火することにより、 pointerup という名前のイベントを発火しなければなりません MUST。mouse の場合、これはデバイスが少なくとも 1 つのボタン押下状態から ボタン未押下状態へ遷移したときです。touch の場合、これはデジタイザーから物理的接触が取り除かれたときです。 pen の場合、これはボタンが押されていない状態で pen がデジタイザーとの物理的接触から取り除かれたとき、 またはホバー中に少なくとも 1 つのボタン押下状態からボタン未押下状態へ遷移したときです。

ホバーをサポートしないデバイスでの入力については、 ユーザーエージェントは、 pointerup イベントを dispatch した後に、 ポインターイベントを発火することにより、 pointerout という名前のイベントに続けて pointerleave という名前の ポインターイベントも発火しなければなりません MUST。

すべての pointerup イベントは pressure 値 0 を持ちます。

ユーザーエージェントは、 ポインターが現在キャプチャされている場合、ポインターキャプチャを暗黙的に解放することも しなければなりません MUST。

ユーザーエージェントは、 ポインターイベントストリームを抑制するシナリオを検出したとき、 ポインターイベントを発火することにより、 pointercancel という名前のイベントを発火しなければなりません MUST。

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

ユーザーエージェントは、 次のいずれかが発生したとき、ポインターイベントを発火することにより、 pointerout という名前のイベントを発火しなければなりません MUST:

• ポインターのターゲットを決定する手順が、 ポインターが要素の外へ移動したことを検出した場合。
• レイアウト変更により、要素のヒットテスト境界が、静止しているポインティングデバイスの キャプチャされていないポインターの下から離れるように移動した場合。
• ユーザーエージェントが、ホバーをサポートしない デバイスについて pointerup イベントを 発火した後（pointerup を参照）。
• ユーザーエージェントが、ポインターイベントストリームを抑制するシナリオを検出した場合。

ユーザーエージェントは、 次のいずれかが発生したとき、ポインターイベントを発火することにより、 pointerleave という名前のイベントを発火しなければなりません MUST:

• ポインターのターゲットを決定する手順が、 ポインターが要素およびそのすべての子孫の外へ移動したことを検出した場合。
• レイアウト変更により、要素およびそのすべての子孫の ヒットテスト境界が、静止しているポインティングデバイスの キャプチャされていないポインターの下から離れるように移動した場合。
• ユーザーエージェントが、ホバーをサポートしない デバイスについて pointerup イベントを 発火した後（pointerup を参照）。
• ユーザーエージェントが、ポインターイベントストリームを抑制するシナリオを検出した場合。

ユーザーエージェントは、 要素がポインターキャプチャを受け取ったとき、ポインターイベントを発火することにより、 gotpointercapture という名前の イベントを発火しなければなりません MUST。このイベントは、ポインターキャプチャを受け取っている要素で発火されます。 そのポインターについての後続のイベントは、この要素で発火されます。ポインターキャプチャの設定および 保留中のポインターキャプチャを処理するセクションを参照してください。

ユーザーエージェントは、 ポインターについてポインターキャプチャが解放された後、ポインターイベントを発火することにより、 lostpointercapture という名前の イベントを発火しなければなりません MUST。 このイベントは、キャプチャが解放された後、そのポインターについての後続のどのイベントよりも前に 発火されなければなりません MUST。このイベントは、 ポインターキャプチャが取り除かれた要素で発火されます。そのポインターについての後続のすべてのイベントは、 click, auxclick, および contextmenu イベントを除き、 イベントターゲットを決定するために通常のヒットテスト機構（この仕様の範囲外）に従います。ポインターキャプチャの解放、ポインターキャプチャの暗黙的な解放、および 保留中のポインターキャプチャを処理する セクションを参照してください。

このセクションは、[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;
	readonly attribute boolean momentum;
};

DOM_DELTA_PIXEL

デルタの測定単位はピクセルでなければなりません MUST。 これは、ほとんどのオペレーティングシステムおよび実装構成において 最も典型的なケースです。

DOM_DELTA_LINE

デルタの測定単位は、個々のテキスト行でなければなりません MUST。これは多くのフォームコントロールの場合に該当します。

DOM_DELTA_PAGE

デルタの測定単位はページでなければならず MUST、 1 画面として定義される場合も、区切られたページとして定義される場合もあります。

deltaX

wheel イベントの既定の動作がスクロールであるユーザーエージェントでは、この値は、 イベントがキャンセルされない場合にスクロールされる x 軸に沿った測定値 （ピクセル、行、またはページ単位）でなければなりません MUST。 そうでない場合、これはホイールデバイスの x 軸まわりの移動についての 実装固有の測定値（ピクセル、行、またはページ単位）です。 この属性の未初期化値は 0.0 でなければなりません MUST。

deltaY

wheel イベントの既定の動作がスクロールであるユーザーエージェントでは、この値は、 イベントがキャンセルされない場合にスクロールされる y 軸に沿った測定値 （ピクセル、行、またはページ単位）でなければなりません MUST。 そうでない場合、これはホイールデバイスの y 軸まわりの移動についての 実装固有の測定値（ピクセル、行、またはページ単位）です。 この属性の未初期化値は 0.0 でなければなりません MUST。

deltaZ

wheel イベントの既定の動作がスクロールであるユーザーエージェントでは、この値は、 イベントがキャンセルされない場合にスクロールされる z 軸に沿った測定値 （ピクセル、行、またはページ単位）でなければなりません MUST。 そうでない場合、これはホイールデバイスの z 軸まわりの移動についての 実装固有の測定値（ピクセル、行、またはページ単位）です。 この属性の未初期化値は 0.0 でなければなりません MUST。

deltaMode

deltaMode 属性には、デルタ値の測定単位を示す指標が含まれます。 既定値は DOM_DELTA_PIXEL （ピクセル）です。 この属性は、デルタ値の測定単位を 示すために、DOM_DELTA 定数のいずれかに設定されなければなりません MUST。 正確な測定値は、デバイス、オペレーティングシステム、および アプリケーション構成に固有です。 この属性の未初期化値は 0 でなければなりません MUST。

momentum

このイベントが、ユーザーが物理的なスクロール操作を終了した後 （例: フリング後にトラックパッドから指を離した後）にスクロール慣性を シミュレートするためにプラットフォームによって合成された場合、この属性は true でなければならず、そうでない場合は false でなければなりません。 この属性の未初期化値は false でなければなりません MUST。

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

deltaX

deltaZ 属性を参照してください。

deltaY

deltaZ 属性を参照してください。

deltaZ

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

deltaMode

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

momentum

momentum 属性を初期化します。

wheel event で preventDefault を呼び出すと、スクロールを防止したり、 または中断したりできます。最大限のスクロール性能のために、ユーザーエージェントは、 スクロールに関連付けられた各 wheel event がキャンセルされるかどうかを確認するために、 それぞれの処理を待たない場合があります。そのような場合、ユーザーエージェントは、 cancelable プロパティが false である wheel イベントを生成すべきです。これは、 preventDefault を使用してスクロールを防止または中断できないことを示します。 それ以外の場合、cancelable は true になります。

特に、ユーザーエージェントは、そのイベントについて 非 passive リスナーが存在しないことを 観測した場合、キャンセル不能な wheel イベントのみを生成すべきです。