PointerEvent:pointerId 屬性

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

pointerIdPointerEvent 介面的一個只讀屬性,它是一個分配給觸發事件的指標的識別符號。該識別符號是唯一的,與其他所有活動的指標事件的識別符號不同。

-1 表示該 PointerEvent 不是由指點裝置生成的。(例如,透過鍵盤啟用按鈕時觸發的 click 事件。)否則,該值可能是隨機生成的,不應依賴它來傳達有關裝置的任何特定資訊。該值僅保證在頁面或會話的生命週期內保持穩定。

注意: pointerId 屬性在不同瀏覽器中的實現不一致,並且並不總是為每個墨跡筆觸或與螢幕的互動保持永續性。要可靠地同時識別螢幕上的多個指點裝置,請參閱 PointerEvent.persistentDeviceId

一個數字。

示例

以下程式碼片段比較了先前儲存的 pointerId 與剛剛觸發的 pointerdown 事件的 pointerId

js
let id; // Let's assume that this is a previously saved pointerId

target.addEventListener("pointerdown", (event) => {
  // Compare previous event's ID that was cached
  // to current event's ID and handle accordingly
  if (id === event.pointerId) process_event(event);
});

規範

規範
指標事件
# dom-pointerevent-pointerid

瀏覽器相容性