ポインターイベント

マルチポインター（たとえばマルチタッチ）のシナリオでは、isPrimary プロパティを使用して、 各ポインタータイプについて アクティブなポインターの集合の中から 主となるポインターを識別します。

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

e という名前の ポインター イベントを発火するとは、PointerEvent インターフェイスおよび 属性とデフォルトアクションで定義されるように属性を設定した PointerEvent を使用して、e という名前の イベントを発火することを意味します。

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

イベントが発火されるターゲットを 決定するには、次のようにします。

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

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

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

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

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

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

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

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

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

特定のハードウェアやプラットフォームによっては、ユーザーエージェントが画面平面に対する トランスデューサーの向きについて受け取る値の組は、tiltX / tiltY または altitudeAngle / azimuthAngle の どちらか一方のみである可能性が高いです。ユーザーエージェントは、これらの値を変換するために次のアルゴリズムを使用しなければなりません。

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

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

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

  let tiltXrad = 0;
  let tiltYrad = 0;

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

  // 方位角を計算する
  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) {
    // 方位角を計算するための情報が不足している
    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;
    }
  }

  // 高度角を計算する
  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 で ディスパッチします

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

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

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

   編集者注記

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

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

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

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

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

1. mouseout を、対応する mouseout MouseEvent とします
2. target を mouseout.target とします
3. pointerout を target で ディスパッチします

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

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

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

   TODO.

4. target を mouseout.target とします
5. pointerout を target で ディスパッチします

ユーザーエージェントは、 次のいずれかが発生した場合、pointerover という名前の ポインターイベントを発火しなければなりません。

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

ユーザーエージェントは、 次のいずれかが発生した場合、pointerenter という名前の ポインターイベントを発火しなければなりません。

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

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

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

ユーザーエージェントは、 ポインターが pointerdown または pointerup イベントを発火させないいずれかの プロパティを変更したとき、pointermove という名前の ポインターイベントを発火しなければなりません。これには、 座標、圧力、接線圧力、 傾き、回転、接触形状（width および height）、または 複数ボタンの同時操作へのあらゆる変更が含まれます。

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

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

pointermove とは対照的に、ユーザーエージェントは、 pointerrawupdate イベントを可能な限り早く、 JavaScript がイベントを処理できる限り高い頻度でディスパッチするべきです。

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

同じ pointerId を持つ別の pointerrawupdate が イベントループ内でまだ ディスパッチされていない場合、ユーザーエージェントは、 新しい pointerrawupdate を、新しい タスクを作成する代わりに そのイベントと統合してもかまいません。 これにより pointerrawupdate が 統合イベントを持つ場合があり、 イベントが イベントループで処理されるとすぐに、 それらすべてが 1 つの pointerrawupdate イベントの 統合イベントとして配信されます。 詳細については getCoalescedEvents を参照してください。

pointerrawupdate と pointermove の順序について、 ユーザーエージェントがプラットフォームから、pointerrawupdate と pointermove の両方のイベントを発生させる更新を受信した場合、 ユーザーエージェントは、対応する pointermove より前に pointerrawupdate イベントをディスパッチしなければなりません。

target を除き、最後の pointermove イベント以降にディスパッチされたすべての pointerrawupdate イベントの 統合イベントリストを連結したものは、その他のイベント 属性に関して、次の pointermove イベントの統合イベントと同じです。 pointerrawupdate の属性は、 ほとんど pointermove と同じですが、 pointerrawupdate では cancelable が false でなければならない点が例外です。

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

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

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

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

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

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

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

ユーザーエージェントは、 次のいずれかが発生した場合、pointerout という名前の ポインターイベントを発火しなければなりません。

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

ユーザーエージェントは、 次のいずれかが発生した場合、pointerleave という名前の ポインターイベントを発火しなければなりません。

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

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

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

この節は、click、auxclick、および contextmenu イベントに関する MouseEvent の定義を補足するものです。 これらのイベントは通常、ユーザーインターフェイスのアクティブ化に結び付いており、キーボードなどの ポインターではない入力デバイスからでも発火します。

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

この節のアルゴリズムでは、ネイティブプラットフォーム OS が次のものを提供すると仮定します。

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

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

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

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

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

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

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

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

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

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

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

1. event、eventType、eventTarget、 bubbles、および cancelable を用いて UIEvent を 初期化します。
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. event を用いて MouseEvent の PointerLock 属性を初期化します
   課題 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. event、eventType、eventTarget、bubbles、および cancelable を用いて MouseEvent を初期化します。
7. event を返します

1. eventType を、有効な MouseEvent タイプを含む DOMString とします
2. eventTarget を、イベントの EventTarget とします
3. bubbles を "false" とします
4. cancelable を "false" とします
5. event を、MouseEvent を使用して イベントを作成した結果とします
6. event、eventType、eventTarget、bubbles、および cancelable を用いて MouseEvent を初期化します。
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. native を用いて ネイティブから MouseEvent の属性を 設定します
7. event を用いて 必要に応じて pointerdown イベントを送信します
8. result を、event を target で ディスパッチした結果とします
9. result が true であり、target が クリックフォーカス可能な フォーカス可能領域である場合、
   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. native を用いて ネイティブから MouseEvent の属性を 設定します
7. event を用いて 必要に応じて pointerup イベントを送信します
8. event を target で ディスパッチします

1. native をネイティブのマウスクリックとします
   注記

   プラットフォームは、クリックを生成する mouseup について、ネイティブのマウスアップを処理するの直後にこれを呼び出すべきです。

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

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. event、native を用いて ネイティブから MouseEvent の属性を設定します
   2. event.screenX が整数値でない場合、丸めます。
   3. event.screenY が整数値でない場合、丸めます。
8. event を target で ディスパッチします
   注記

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

   編集者注記

   あらゆる「デフォルトアクション」は、ディスパッチ中にターゲットの アクティブ化 動作 アルゴリズムをトリガーすることで処理されます。そのため、ここで処理する必要はありません。 ただし、既存の仕様が disabled/css-pointer-events/inert/... を処理していることを確認する必要があります。

   注記

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

   注記

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

1. native をネイティブのマウスダブルクリックとします
   注記

   ダブルクリックを生成するマウスクリックについて、ネイティブのマウスクリックを処理した直後に これを呼び出すべきです。

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

1. native をネイティブのマウス移動とします
   課題 2

   このアルゴリズムは、PointerEvents のディスパッチについて、現在明示的に 規定されていないため、いくつかの仮定を置いています。pointerevents/285 が 解決された後、これを更新する必要がある場合があります。

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

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

   2. mouseout を用いて 必要に応じて pointerout イベントを送信します
   3. mouseout を target で ディスパッチします
      注記

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

   4. leaveElements を、targetDomPath と共通するすべての要素を削除した 最後の マウス DOM パスのコピーとします。
   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. mouseleave を用いて 必要に応じて pointerleave イベントを送信します
      4. result を、mouseleave を element で ディスパッチした 結果とします
5. 新しい要素に進入するイベントを生成します。
   1. target が 最後のマウス要素でない場合、
      1. mouseover を、"mouseover" および target を用いて キャンセル可能な MouseEvent を作成した結果とします
         編集者注記

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

      2. mouseover を用いて 必要に応じて pointerover イベントを送信します
      3. mouseout を target で ディスパッチします
         注記

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

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

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

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

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

         3. mouseenter を用いて 必要に応じて pointerenter イベントを送信します
            注記

            Shadow DOM 要素の互換性を確認する。Chrome/Linux は、この イベントを要素と shadow root で発火する。

         4. result を、mouseenter を element で ディスパッチした 結果とします
      6. 最後のマウス要素を target に設定します
      7. 最後のマウス DOM パスを targetDomPath に設定します
6. mousemove を、"mousemove" および element を用いて キャンセル可能な MouseEvent を作成した 結果とします
7. mousemove の PointerLock 属性を設定します
8. mousemove を用いて 必要に応じて pointermove イベントを送信します
9. mousemove を element で ディスパッチします

1. native をネイティブの mousedown またはポインターイベントとします
2. target を、イベントの EventTarget とします
   1. menuevent を、"contextmenu"、target を用いて PointerEvent を作成した結果とします
   2. native が有効である場合、
      1. native を用いて ネイティブから MouseEvent の属性を設定します
   3. result を、menuevent を target で ディスパッチした 結果とします
   4. result が true である場合、UA のコンテキストメニューを表示します

ユーザーが非プライマリポインターボタンを押して 解放したとき、またはそのような操作をシミュレートする方法で ポインターをアクティブ化したとき、auxclick イベントタイプは、ポインターによって示された 最上位の イベントターゲットでディスパッチされなければなりません。マウスボタンの作動 方法はポインターデバイスおよび 環境設定に依存します。たとえば、画面上の 位置や、ポインティング デバイスのボタンを押してから解放するまでの遅延に依存してもかまいません。

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

auxclick イベントの前に、同じ要素上で mousedown および mouseup イベントが発生してもかまいません。その他の ノードタイプ（たとえばテキストノード）間の変更は無視します。環境 設定によっては、ポインティングデバイスのボタンを押してから 解放するまでの間に、mouseover、 mousemove、および mouseout のイベントタイプのうち 1 つ以上が発生した場合でも、 auxclick イベントが ディスパッチされてもかまいません。

auxclick イベントタイプの デフォルトアクションは、 イベントの ターゲットおよび button または buttons 属性の値に応じて異なります。 auxclick イベントタイプの典型的な デフォルトアクションは次のとおりです。

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

myLink.addEventListener("auxclick", function(e) {
  if (e.button === 1) {
    // たとえばリンクを中央クリックしたときに新しいタブを開くという
    // デフォルト動作を、これによって防止できる。
    e.preventDefault();
    // リンクまたはリンクではないボタンを新しいタブで開く処理など、
    // アプリに適した方法で中央ボタンのクリックを処理するための
    // 別の処理を行う。タブストリップでタブを閉じるなど、クリック操作時に
    // 行うべきその他の操作もここで実行できる。
  }
});

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

ユーザーがプライマリポインターボタンを押して 解放したとき、またはそのような操作をシミュレートする方法で ポインターをアクティブ化したとき、click イベントタイプは、ポインターによって示された 最上位の イベントターゲットでディスパッチされなければなりません。マウスボタンの作動 方法はポインターデバイスおよび 環境設定に依存します。たとえば、画面上の 位置や、ポインティング デバイスのボタンを押してから解放するまでの遅延に依存してもかまいません。

click イベントは、プライマリポインター ボタンに対してのみ発火するべきです（すなわち、button 値が 0、 buttons 値が 1 の場合）。 セカンダリボタン （標準的なマウスの中央ボタンや右ボタンなど）は、 click イベントを発火してはなりません。非プライマリボタンに 関連付けられた対応するイベントについては、auxclick を参照してください。

click イベントの前に、同じ要素上で mousedown および mouseup イベントが発生してもかまいません。その他の ノードタイプ（たとえばテキストノード）間の変更は無視します。環境 設定によっては、ポインティングデバイスのボタンを押してから 解放するまでの間に、mouseover、 mousemove、および mouseout のイベントタイプのうち 1 つ以上が発生した場合でも、 click イベントが ディスパッチされてもかまいません。また、click イベントの後に dblclick イベントが続いてもかまいません。

ユーザーが、大きな line-height が指定された <p> 要素の子であるテキストノード上でマウスボタンを押し、 マウスをわずかに移動して、テキストを含む領域上から外れたものの、 その <p> 要素の包含 ブロック内には留まり（すなわち、ポインターは 同じテキストブロックの行間にあるが、テキストノード自体の 上にはない）、その後マウスボタンを離した場合、通常の時間的な ヒステリシスの範囲内であれば、click に対して click イベントが引き続き発生する可能性が高いです。これは、 ユーザーが同じ要素の範囲内に 留まっているためです。ユーザーエージェントによって生成される マウスイベントはテキストノード上ではディスパッチされないことに注意してください。

ポインターデバイスに関連付けられることに加えて、 click イベントタイプは、要素の アクティブ化の一部としてディスパッチされなければなりません。

click イベントタイプの デフォルトアクションは、 イベントの ターゲットおよび button または buttons 属性の値に応じて異なります。 click イベントタイプの典型的な デフォルトアクションは次のとおりです。

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

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

contextmenu イベントがマウスの右 ボタンによってトリガーされた場合、 contextmenu イベントは、mousedown イベントの後に ディスパッチされなければなりません。

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

click イベントと同様に、dblclick イベントは、 プライマリポインターボタンに対してのみ発火するべきです。セカンダリボタンは dblclick イベントを発火してはなりません。

ユーザーエージェントは、 ポインティングデバイスの ボタンが要素上で押されたとき、このイベントをディスパッチしなければなりません。

ユーザーエージェントは、 ポインティングデバイスが要素またはその子孫 要素の境界上へ移動したとき、このイベントをディスパッチしなければなりません。また、ユーザーエージェントは、 要素またはその子孫のいずれかがプライマリ ポインティングデバイスの下へ移動したときにも、このイベントをディスパッチしなければなりません。 このイベントタイプは mouseover と似ていますが、 バブリングしない点、およびポインターデバイスが要素からその子孫要素の 1 つの境界上へ移動したときにディスパッチされてはならない点が 異なります。

ユーザーエージェントは、 ポインティングデバイスが要素およびそのすべての 子孫要素の境界から外へ移動したとき、このイベントをディスパッチしなければなりません。また、ユーザー エージェントは、要素またはその子孫のいずれかが プライマリポインティングデバイスの下から外れるように移動したときにも、このイベントを ディスパッチしなければなりません。このイベントタイプは mouseout と似ていますが、 バブリングしない点、およびポインティングデバイスが 要素の境界とそのすべての子の境界から離れるまでディスパッチされてはならない点が異なります。

ユーザーエージェントは、 ポインティングデバイスが要素上にある間に 移動したとき、このイベントをディスパッチしなければなりません。ポインティングデバイスの移動中のイベントの 発生頻度は実装、デバイス、および プラットフォームに固有ですが、ポインターデバイスが継続的に移動している場合、マウス移動の各発生ごとに 単一のイベントを発火するのではなく、複数の連続した mousemove イベントを 発火するべきです。実装には、 応答性とパフォーマンスのバランスを取るための最適な発生頻度を決定することが 推奨されます。

ユーザーエージェントは、 ポインティングデバイスが要素の境界から外へ移動したとき、または要素が プライマリポインティングデバイスの下から外れるように移動したとき、 このイベントをディスパッチしなければなりません。 このイベントタイプは mouseleave と似ていますが、 バブリングする点、およびポインターデバイスが 要素からその子孫要素の 1 つの境界上へ移動したときにディスパッチされなければならない点が異なります。

ユーザーエージェントは、 ポインティングデバイスが要素の境界上へ移動したとき、または要素が プライマリポインティングデバイスの下へ移動したとき、 このイベントをディスパッチしなければなりません。 このイベントタイプは mouseenter と似ていますが、 バブリングする点、および祖先要素が同じ イベントリスナーインスタンスの ターゲットである要素の 境界上へポインターデバイスが移動したときにディスパッチされなければならない点が異なります。

ユーザーエージェントは、 ポインティングデバイスの ボタンが要素上で解放されたとき、このイベントをディスパッチしなければなりません。

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

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