Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Juli 2020⁩.

Die schreibgeschützte pointerId-Eigenschaft des PointerEvent-Interfaces ist eine Kennung, die dem Zeiger zugewiesen ist, der das Ereignis ausgelöst hat. Die Kennung ist einzigartig und unterscheidet sich von den Kennungen aller anderen aktiven Zeigerereignisse.

Ein Wert von -1 zeigt an, dass das PointerEvent nicht von einem Zeigegerät generiert wurde. (Zum Beispiel ein click-Ereignis, das auf einer Schaltfläche ausgelöst wurde, die über die Tastatur aktiviert wurde.) Andernfalls kann der Wert zufällig generiert werden und sollte nicht darauf vertrauen, bestimmte Informationen über das Gerät zu vermitteln. Der Wert ist nur für die Lebensdauer der Seite oder Sitzung stabil garantiert.

Hinweis: Die pointerId-Eigenschaft wird in verschiedenen Browsern inkonsistent implementiert und bleibt nicht immer für jeden Tintenstrich oder jede Interaktion mit dem Bildschirm bestehen. Für eine zuverlässige Methode zur gleichzeitigen Identifizierung mehrerer Zeigegeräte auf einem Bildschirm, siehe PointerEvent.persistentDeviceId.

Wert

Eine Zahl.

Beispiele

Der folgende Codeausschnitt 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