PointerEvent: pointerId プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

pointerId は PointerEvent インターフェイスの読み取り専用プロパティで、特定のポインターのイベントに割り当てられた識別子です。 識別子は一意であり、他のすべてのアクティブポインターのイベントの識別子と異なります。 値はランダムに生成される可能性があるため、特定の意味を伝えることは保証されません。

メモ: pointerId プロパティの実装は、ブラウザー間でばらつきがあり、常に各インクストロークや、画面の操作に対して維持されるわけではありません。画面に同時に存在する複数のポインティングデバイスを確実に識別する方法については、PointerEvent.persistentDeviceId を参照してください。

値

数値です。

例

次のコードスニペットは、以前に保存された pointerId と、発生したばかりの pointerdown イベントのものとを比較します。

js
let id; // これが以前に保存された pointerId であると仮定しましょう

target.addEventListener(
  "pointerdown",
  (event) => {
    // キャッシュされた前のイベントの ID を現在の
    // イベントの ID と比較し、それに応じて処理する
    if (id === event.pointerId) process_event(event);
  },
  false,
);

仕様書

Specification
Pointer Events
# dom-pointerevent-pointerid

ブラウザーの互換性

BCD tables only load in the browser