PointerEvent: pointerId-Eigenschaft

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.

Die schreibgeschützte Eigenschaft pointerId der PointerEvent-Schnittstelle ist ein Bezeichner, der einem bestimmten Zeigerereignis zugewiesen wird. Der Bezeichner ist einzigartig, da er sich von den Bezeichnern aller anderen aktiven Zeigerereignisse unterscheidet. Da der Wert möglicherweise zufällig generiert wird, ist er nicht garantiert, eine bestimmte Bedeutung zu vermitteln.

Hinweis: Die pointerId-Eigenschaft wird von Browsern inkonsistent implementiert und bleibt nicht immer für jeden Tintenstrich oder jede Interaktion mit dem Bildschirm bestehen. Für eine zuverlässige Methode, um mehrere Zeigegeräte gleichzeitig auf einem Bildschirm zu identifizieren, siehe PointerEvent.persistentDeviceId.

Wert

Eine Zahl.

Beispiele

Der folgende Codeabschnitt vergleicht eine zuvor gespeicherte pointerId mit derjenigen des gerade ausgelösten pointerdown-Ereignisses.

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);
  },
  false,
);

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-pointerid

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
pointerId

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support