ポインターイベント

5.1 PointerEvent インターフェイス

dictionary PointerEventInit : MouseEventInit {
    long        pointerId = 0;
    double      width = 1;
    double      height = 1;
    float       pressure = 0;
    float       tangentialPressure = 0;
    long        tiltX = 0;
    long        tiltY = 0;
    long        twist = 0;
    DOMString   pointerType = "";
    boolean     isPrimary = false;
};

[Constructor(DOMString type, optional PointerEventInit eventInitDict), Exposed=Window]
interface PointerEvent : MouseEvent {
    readonly        attribute long        pointerId;
    readonly        attribute double      width;
    readonly        attribute double      height;
    readonly        attribute float       pressure;
    readonly        attribute float       tangentialPressure;
    readonly        attribute long        tiltX;
    readonly        attribute long        tiltY;
    readonly        attribute long        twist;
    readonly        attribute DOMString   pointerType;
    readonly        attribute boolean     isPrimary;
};

5.2 ポインターイベント型

以下は本仕様で定義されるイベント型です。

プライマリポインターの場合、これらのイベント（gotpointercaptureとlostpointercaptureを除く）は互換性マウスイベントも発火する場合があります。

9.1 touch-action CSSプロパティ

touch-action CSSプロパティは、タッチ入力がユーザーエージェントによるデフォルト動作（パンやズーム等）を引き起こしてもよいかを決定します。詳細はtouch-action値のセクションを参照。

ユーザーエージェントによるタッチ動作実行中、ユーザーエージェントは以降そのポインターに対するポインターイベントを発火してはなりません。加えて、以下全てが成立した場合、ユーザーエージェントはそのポインターのイベントストリームを終了するため、pointercancel（以降pointerout・1つ以上のpointerleaveイベント）という名前のポインターイベントを発火しなければなりません：

• ユーザーエージェントがタッチ入力をタッチ動作として消費することを（本仕様の範囲外の方法で）判断した場合
• そのポインターに対してpointerdownイベントが送信されている
• そのポインターに対し（上記pointerdownに続く）pointerupまたはpointercancelイベントがまだ送信されていない

9.2 サポートされるタッチ動作の判定

ユーザーが要素をタッチした際、その効果はtouch-actionプロパティの値と要素及び祖先のデフォルトタッチ動作によって以下のように決定されます：

• タッチ動作が要素の座標空間で許可されていれば、その動作は当該要素のtouch-actionに準拠するとみなされます。CSS変形が適用されている場合、要素の座標空間はスクリーン座標と異なることがあり、軸の取り扱いも変わります（例：要素が90度回転している場合、要素のX軸はスクリーン座標のY軸と平行になる）。
• タッチ動作は、ヒットテストされた要素から最近傍のデフォルトタッチ動作を持つ祖先要素まで全てのtouch-actionプロパティに準拠していればサポートされます（該当する両要素を含む）。
• 一度タッチ動作が開始され、ユーザーエージェントがそれをタッチ動作として扱うかどうかを決定した場合、関連するtouch-action値の変更はそのタッチ動作中無視されます。例：pointerdownハンドラ内でautoからnoneに変更しても、そのポインターがアクティブな間はデフォルトタッチ動作の継続・中止には影響しません。

9.3 touch-action値の詳細

auto

ユーザーエージェントは、要素上で開始されたタッチに対し、ビューポートのパンやズームなど許可されているタッチ動作を任意に決定してもよい。

none

要素上で開始されたタッチは、デフォルトタッチ動作を引き起こしてはならない。

pan-x
pan-y

ユーザーエージェントは、要素上で開始されたタッチについて、列挙された全方向でスクロールを開始する目的に限定して考慮してもよい。スクロール開始後は、逆方向への操作も許容される（逆方向開始が許されない場合でも、開始後の方向転換は可能）。ただしスクロール開始軸が1軸に限定されている場合（例：pan-y）、スクロール中に軸を変更することはできない。

manipulation

ユーザーエージェントは、要素上で開始されたタッチについて、スクロールや連続ズームのみを目的として考慮してもよい。autoでサポートされる追加動作は本仕様の範囲外。

10.2 ポインターキャプチャの設定

ポインターキャプチャは、element.setPointerCapture(pointerId)メソッドを呼び出すことで設定できます。このメソッドが呼び出されたとき、ユーザーエージェントは以下の手順を実行しなければなりません：

1. メソッド引数として指定されたpointerIdが、いずれのアクティブポインターにも一致しない場合、NotFoundErrorという名前のDOMExceptionをスローする。
2. このメソッドが呼び出されたElementが[DOM4]のconnectedでない場合、InvalidStateErrorという名前の例外をスローする。
3. ドキュメントがロックされた要素（[PointerLock]）を持つ場合、このメソッドが呼び出されたら、InvalidStateErrorという名前の例外をスローする。
4. ポインターがアクティブボタン状態でない場合、これらの手順を終了する。
5. 指定されたpointerIdに対して、保留中のポインターキャプチャ対象の上書きを、このメソッドが呼び出されたElementに設定する。

10.3 ポインターキャプチャの解除

ポインターキャプチャは、element.releasePointerCapture(pointerId)メソッドを明示的に呼び出すことで解除します。このメソッドが呼び出された場合、ユーザーエージェントは以下の手順を実行しなければなりません：

1. メソッド引数として指定されたpointerIdが、いずれのアクティブポインターにも一致しない場合、かつこの手順が暗黙のポインターキャプチャ解除によるものでない場合、NotFoundErrorという名前のDOMExceptionをスローする。
2. 指定したElementがpointerIdに対してhasPointerCaptureがfalseの場合、これらの手順を終了する。
3. 指定したpointerIdに対して、保留中のポインターキャプチャ対象の上書きが設定されていればクリアする。

10.4 暗黙のポインターキャプチャ

一部の入力デバイス（タッチスクリーンなど）は「ダイレクトマニピュレーション」メタファーを実装しており、ポインターが主にアクティブになったUI要素に作用する（直接接触の物理的錯覚を提供し、UI上に浮かぶカーソルによる間接的接触とは異なる）ようになっています。こうしたデバイスはInputDeviceCapabilities.pointerMovementScrollsプロパティで識別され、「暗黙のポインターキャプチャ」挙動を以下のように持つべきです。

ダイレクトマニピュレーションデバイスは、pointerdownリスナーが呼び出される直前に、ちょうどsetPointerCaptureがターゲット要素に呼ばれたかのように振る舞うべきです。hasPointerCaptureAPIを使って（例：pointerdownリスナー内で）これが発生したかどうか判定できます。次のポインターイベントが発火する前にreleasePointerCaptureが呼ばれない場合、通常通りgotpointercaptureイベントがターゲットにディスパッチされ、キャプチャが有効であることを示します。

10.5 暗黙のポインターキャプチャ解除

pointerupまたはpointercancelイベントを発火した直後、ユーザーエージェントは、発火したpointerupまたはpointercancelイベントのpointerIdについて、保留中のポインターキャプチャ対象の上書きをクリアし、必要に応じてlostpointercaptureを発火するために保留中のポインターキャプチャの処理手順を実行しなければなりません()。保留中のポインターキャプチャの処理手順実行後、ポインターがホバーをサポートしている場合、ユーザーエージェントはキャプチャなしの現在位置に合わせて必要な境界イベントも送信しなければなりません。

ユーザーエージェントがclickイベント発火をサポートしている場合（互換性マウスイベント参照）、暗黙の解除シナリオでclickおよびlostpointercaptureイベントの両方が発火される場合、clickはlostpointercaptureより前に発火されるべきです。

ポインターキャプチャ対象の上書きがconnected（[DOM4]）でなくなった場合、保留中のポインターキャプチャ対象の上書きとポインターキャプチャ対象の上書きノードはクリアされるべきであり、該当ポインターについてlostpointercaptureイベントもドキュメントで発火されるべきです。

要素上でポインターロック（[PointerLock]）が正常に適用された場合、キャプチャ中または保留中のキャプチャ要素がある場合は、releasePointerCapture()メソッドが呼ばれたかのように手順を実行しなければなりません。

11.1 レガシーマウスポインターの有効位置の追跡

プライマリポインターのみが互換性マウスイベントを生成できますが、複数のプライマリポインターが同時にアクティブとなり、それぞれが互換性マウスイベントを生成する場合があります。すべての互換性イベントはMouseEventコード上は単一のマウスデバイスからのものと見なされるため、ユーザーエージェントは単一デバイスの観点で互換性マウスイベントの整合性を保証することが推奨されます。マウス遷移イベント（mouseover、mouseout、mouseenter、mouseleave）については、全イベントターゲットに対する入出状態が[UIEVENTS]で示唆される通りに有効であることが必要です。ユーザーエージェントは、ドキュメント内でレガシーマウスポインターの有効位置を次のように維持することでこれを保証するべきです。

ユーザーエージェントは、pointerdown・pointerup・pointermoveイベントの発火直前や、windowでのpointerleaveイベント直前に、以下の手順を実行すべきです：

1. Tを、発火されるpointerdown・pointerup・pointermoveイベントのターゲットとする。pointerleaveイベントの場合はTを未設定とする。
2. Tと現在の有効レガシーマウスポインター位置が両方未設定、または両者が等しい場合は手順を終了する。
3. 現在の有効レガシーマウスポインター位置からTにマウスが移動したものとして、[UIEVENTS]のマウス仕様に従いmouseover、mouseout、mouseenter、mouseleaveイベントを発火する。未設定値はウィンドウ外のマウス位置と見なす。
4. 有効レガシーマウスポインター位置をTに設定する。

11.2 ホバー対応デバイスのマッピング

ユーザーエージェントがホバー対応デバイスのポインターイベントを発火する際、以下の手順を実行すべきです：

1. 発火するポインターイベントのisPrimaryプロパティがfalseの場合、ポインターイベントを発火し、これ以降の手順を終了する。
2. 発火するポインターイベントがpointerdown・pointerup・pointermoveイベント、またはwindowでのpointerleaveイベントの場合、レガシーマウスポインターの有効位置の追跡に従い互換性マウス遷移イベントを発火する。
3. ポインターイベントを発火する。
4. 発火したポインターイベントがpointerdownで、イベントがキャンセルされた場合、当該pointerTypeにPREVENT MOUSE EVENTフラグをセットする。
5. 当該pointerTypeのPREVENT MOUSE EVENTフラグが未セットで、発火されたポインターイベントが以下の場合：
   • pointerdownの場合、mousedownイベントを発火する。
   • pointermoveの場合、mousemoveイベントを発火する。
   • pointerupの場合、mouseupイベントを発火する。
   • pointercancelの場合、windowでmouseupイベントを発火する。
6. 発火されたポインターイベントがpointerupまたはpointercancelの場合、当該pointerTypeのPREVENT MOUSE EVENTフラグをクリアする。

11.3 ホバー非対応デバイスのマッピング

多くのタッチスクリーンなど一部デバイスは、アクティブ状態以外で座標のホバーをサポートしません。既存のマウスイベント用コンテンツでは、マウスがイベントを生成する前提で、次のような性質が期待されます：

• 入力がアクティベーションと独立してホバーできる（例：ボタン未押下のマウスカーソル移動）。
• 入力は通常、クリック前に要素上でmousemoveイベントを生成する。

このため、ユーザーエージェントはこれら入力デバイス向けに異なるマッピングを提供する必要があります。ユーザーエージェントがホバー非対応デバイスのポインターイベントを発火する際、以下の手順を実行すべきです：

1. 発火するポインターイベントのisPrimaryプロパティがfalseの場合、ポインターイベントを発火し、これ以降の手順を終了する。
2. 発火するポインターイベントがpointeroverかつ、当該ポインターでpointerdownイベントがまだ発火されていない場合、互換性維持のためmousemoveイベントを発火する。
3. 発火するポインターイベントがpointerdown・pointerup・pointermoveイベント、またはwindowでのpointerleaveイベントの場合、レガシーマウスポインターの有効位置の追跡に従い互換性マウス遷移イベントを発火する。
4. ポインターイベントを発火する。
5. 発火したポインターイベントがpointerdownで、イベントがキャンセルされた場合、当該pointerTypeにPREVENT MOUSE EVENTフラグをセットする。
6. 当該pointerTypeのPREVENT MOUSE EVENTフラグが未セットで、発火されたポインターイベントが以下の場合：
   • pointerdownの場合、mousedownイベントを発火する。
   • pointermoveの場合、mousemoveイベントを発火する。
   • pointerupの場合、mouseupイベントを発火する。
   • pointercancelの場合、windowでmouseupイベントを発火する。
7. 発火されたポインターイベントがpointerupまたはpointercancelの場合、当該pointerTypeのPREVENT MOUSE EVENTフラグをクリアする。