ポインターイベント

マルチポインター（たとえばマルチタッチ）のシナリオでは、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 を返します

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

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

ユーザーエージェントは 必ず ポインターイベントを発火する。その名前は pointerenter であり、次のいずれかが発生した場合に行う：

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

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

入力 デバイスがサポートしないものが ホバーである場合、ユーザー エージェントは 必ず 次も行う：発火するポインター イベントの名前を pointerover とし、続いて ポインターイベントを発火する。その名前は pointerenter とする。これらは次より前に行う： ディスパッチ、pointerdown イベントの。

ユーザーエージェントは、 ポインターが 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つも押されていない状態へ。

入力 デバイスがサポートしないものが ホバーである場合、ユーザー エージェントは 必ず 次も行う：発火するポインター イベントの名前を pointerout とし、続いて ポインターイベントを発火する。その名前は pointerleave とする。これらは次の後に行う： ディスパッチ、pointerup イベントの。

すべての 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() メソッド。この節が補足するのは、[DOM] の手順であり、新たに初期化する MouseEvent オブジェクトに、これらの任意の修飾子 状態を持たせるためのものである。

次を構築するために：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. target において event を配送 する

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

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

2. target を、native からのビューポート相対座標を用いたヒットテストの結果と する
3. 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. event と native を用いて ネイティブから MouseEvent 属性を設定する
   2. event.screenX が整数値でない場合、丸める。
   3. event.screenY が整数値でない場合、丸める。
8. target において event を配送 する
   注記

   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. target において event を配送 する

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. 配送 target において mouseout を配送する
      注記

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

   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 を、element における mouseleave の配送 の結果とする
5. 新しい要素に入る際のイベントを生成する:
   1. target が最後のマウス要素でない 場合、
      1. mouseover を、"mouseover" と target を用いてキャンセル可能な MouseEvent を作成する処理の結果とする
         編集者注

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

      2. mouseover を用いて、場合によっては pointerover イベントを送信する
      3. 配送 target において mouseout を配送する
         注記

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

      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 イベントを送信する
            注記

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

         4. result を、element における mouseenter の配送 の結果とする
      6. 最後のマウス要素を target に設定する
      7. 最後のマウス DOM パスを targetDomPath に設定する
6. mousemove を、"mousemove" と element を用いてキャンセル可能な MouseEvent を作成する処理の結果と する
7. mousemove の PointerLock 属性を設定する
8. mousemove を用いて、場合によっては pointermove イベントを送信する
9. element において mousemove を配送 する

1. native をネイティブの mousedown またはポインターイベントとする
2. target をイベントの EventTarget とする
   1. menuevent を、"contextmenu" と target を用いてPointerEvent を作成する処理の 結果とする
   2. native が有効である場合、
      1. native を用いてネイティブから MouseEvent 属性を設定する
   3. result を、target における menuevent の配送 の結果とする
   4. result が true の場合、ユーザーエージェントのコンテキストメニューを表示する

ユーザーが非プライマリポインターボタンを押して 解放したとき、またはそのような操作をシミュレートする方法で ポインターをアクティブ化したとき、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 イベントのみを生成するべきです。