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

BCD tables only load in the browser