CKTIS / JavaScript
PointerEvent: aanwijzer-ID en primaire aanwijzer
`pointerId` koppelt gebeurtenissen van dezelfde actieve aanwijzer; `isPrimary` geeft aan of die aanwijzer primair is voor zijn invoertype.
Versie: 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 is een alleen-lezen numerieke ID. Je koppelt er gebeurtenissen van dezelfde actieve aanwijzer mee en onderscheidt die aanwijzer van andere actieve aanwijzers, zoals een tweede aanraakpunt. Het is geen permanente apparaat-ID: leid het apparaattype niet af uit het getal en ga er niet van uit dat de ID tussen interacties gelijk blijft of nooit opnieuw wordt gebruikt. Bij door de browser gegenereerde gebeurtenissen betekent -1 dat er geen aanwijsapparaat aan te pas kwam, bijvoorbeeld bij een click via het toetsenbord.
isPrimary is een alleen-lezen booleaanse eigenschap. true duidt de primaire aanwijzer aan voor die pointerType, niet de primaire knop. De muisaanwijzer is primair. Voor aanraking en pen is het de eerste aanwijzer van dat type die actief wordt terwijl geen andere aanwijzer van hetzelfde type actief is. Een muis en een aanraakpunt kunnen dus tegelijk isPrimary === true hebben. Wanneer de primaire aanraking eindigt, wordt een nog actief aanraakpunt niet automatisch primair.
Om meerdere gebaren te volgen, sla je bij pointerdown de toestand op in een Map met pointerId als sleutel, zoek je die op bij pointermove en verwijder je die bij pointerup of pointercancel. Wil je voor alle invoertypen samen maar één aanwijzer volgen, onthoud dan de gekozen ID: alleen filteren op isPrimary is niet genoeg. Deze eigenschappen horen bij een web-API, niet bij ECMAScript; controleer de ondersteuning in je doelomgeving.
Voorbeelden
<!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>Resultaat
pointerdown touch 7 true pointerdown touch 8 false pointermove touch 7 true pointermove mouse 12 true
Sla het voorbeeld op als HTML-bestand en open het in een browser die `PointerEvent` ondersteunt. De uitvoer verschijnt op de pagina. ID `7` koppelt twee aanraakgebeurtenissen, `8` duidt een ander aanraakpunt aan, en zowel de muis als het eerste aanraakpunt heeft de waarde `true`. De code leest expliciet opgegeven waarden uit synthetische gebeurtenissen. Hij vuurt die gebeurtenissen niet af en test niet hoe de browser de waarden bij echte invoer toekent.
Gerelateerde lessen
- JavaScript · Les 35 · Gemiddeld · Versie: 3