PointerEvent: isPrimary-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 isPrimary-Eigenschaft des PointerEvent-Interfaces zeigt an, ob das Zeigergerät, das das Ereignis erstellt hat, der primäre Zeiger ist. Sie gibt true zurück, wenn der Zeiger, der das Ereignis ausgelöst hat, der primäre ist, und false andernfalls.

In einem Multi-Zeiger-Szenario (wie z.B. ein Touchscreen, der mehr als einen Berührungspunkt unterstützt) wird diese Eigenschaft verwendet, um einen Hauptzeiger unter den aktiven Zeigern für jeden Zeigertyp zu identifizieren. Nur ein primärer Zeiger wird Kompatibilitäts-Mausereignisse erzeugen. Autoren, die nur eine Einzelzeiger-Interaktion wünschen, können dies erreichen, indem sie nicht-primäre Zeiger ignorieren.

Ein Zeiger wird als primär betrachtet, wenn der Zeiger ein Mausgerät darstellt. Ein Zeiger, der Stifteingabe darstellt, wird als primäre Stifteingabe betrachtet, wenn sein pointerdown-Ereignis ausgelöst wurde, als keine anderen aktiven Zeiger, die Stifteingaben darstellen, existierten. Ein Zeiger, der Berührungseingabe darstellt, wird als primäre Berührungseingabe betrachtet, wenn sein pointerdown-Ereignis ausgelöst wurde, als keine anderen aktiven Zeiger, die Berührungseingaben darstellen, existierten.

Wenn zwei oder mehr Zeigergerätetypen gleichzeitig verwendet werden, werden mehrere Zeiger (einer für jeden pointerType) als primär betrachtet. Beispielsweise werden ein Berührungskontakt und ein Mauszeiger, die gleichzeitig bewegt werden, Zeiger erzeugen, die beide als primär betrachtet werden. Wenn es mehrere primäre Zeiger gibt, werden diese Zeiger alle Kompatibilitäts-Mausereignisse erzeugen (siehe Pointer events für weitere Informationen über Zeiger-, Maus- und Berührungsinteraktionen).

Wert

Ein boolean, true, wenn der Zeiger für dieses Ereignis der primäre Zeiger ist, und false andernfalls.

Beispiele

Dieses Beispiel verdeutlicht die Verwendung des Werts von isPrimary, um die geeignete Verarbeitungsfunktion aufzurufen.

js
target.addEventListener(
  "pointerdown",
  (event) => {
    if (event.isPrimary) {
      process_primary_pointer(event);
    } else {
      process_secondary_pointer(event);
    }
  },
  false,
);

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-isprimary

Browser-Kompatibilität

BCD tables only load in the browser