PointerEvent: isPrimary-Eigenschaft

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).

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