CKTIS / JavaScript
PointerEvent: Zeiger-ID und primärer Zeiger
`pointerId` ordnet Ereignisse demselben aktiven Zeiger zu; `isPrimary` zeigt, ob dieser Zeiger für seinen Eingabetyp primär ist.
Version: Current web platform; runtime support varies
Syntax
// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId // number, read-only
event.isPrimary // boolean, read-onlypointerId ist eine schreibgeschützte numerische Kennung. Sie verknüpft Ereignisse desselben aktiven Zeigers und unterscheidet ihn von anderen aktiven Zeigern, etwa von einem zweiten Berührungspunkt. Sie ist keine dauerhafte Gerätekennung: Leite aus der Zahl keinen Gerätetyp ab und gehe nicht davon aus, dass sie über Interaktionen hinweg gleich bleibt oder nie erneut vergeben wird. Bei vom Browser erzeugten Ereignissen steht -1 für kein Zeigegerät, etwa bei einem per Tastatur ausgelösten click.
isPrimary ist eine schreibgeschützte boolesche Eigenschaft. true kennzeichnet den primären Zeiger für den jeweiligen pointerType, nicht die primäre Taste. Der Mauszeiger ist primär. Bei Berührung und Stift ist es der erste Zeiger des jeweiligen Typs, der aktiv wird, während kein anderer Zeiger dieses Typs aktiv ist. Maus und Berührung können daher gleichzeitig isPrimary === true haben. Endet die primäre Berührung, wird ein noch aktiver Berührungspunkt nicht automatisch primär.
Speichere für mehrere Gesten bei pointerdown den Zustand in einer Map mit pointerId als Schlüssel, lies ihn bei pointermove und entferne ihn bei pointerup oder pointercancel. Wenn du über alle Eingabetypen hinweg nur einen Zeiger brauchst, merke dir die gewählte ID; allein nach isPrimary zu filtern reicht nicht. Beide Eigenschaften gehören zu einer Web-API, nicht zu ECMAScript. Prüfe die Unterstützung in der Zielumgebung.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>PointerEvent example</title>
<pre id="output"></pre>
<script>
const events = [
new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 7, isPrimary: true }),
new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 8, isPrimary: false }),
new PointerEvent("pointermove", { pointerType: "touch", pointerId: 7, isPrimary: true }),
new PointerEvent("pointermove", { pointerType: "mouse", pointerId: 12, isPrimary: true }),
];
const lines = [];
for (const event of events) {
lines.push(`${event.type} ${event.pointerType} ${event.pointerId} ${event.isPrimary}`);
}
document.getElementById("output").textContent = lines.join("\n");
</script>Ergebnis
pointerdown touch 7 true pointerdown touch 8 false pointermove touch 7 true pointermove mouse 12 true
Speichere das Beispiel als HTML-Datei und öffne es in einem Browser mit `PointerEvent`-Unterstützung. Die Ausgabe erscheint auf der Seite. Die ID `7` verbindet zwei Berührungsereignisse, `8` steht für einen anderen Kontakt, und Maus und erster Kontakt haben beide den Wert `true`. Der Code liest ausdrücklich gesetzte Werte aus synthetischen Ereignissen. Er löst keine Ereignisse aus und prüft nicht, wie der Browser die Werte bei echter Eingabe vergibt.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Mittlere Stufe · Version: 3