CKTIS / JavaScript
PointerEvent: identifikator i primarni pokazivač
`pointerId` povezuje događaje istog aktivnog pokazivača; `isPrimary` govori je li taj pokazivač primaran za svoju vrstu unosa.
Verzija: Current web platform; runtime support varies
Sintaksa
// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId // number, read-only
event.isPrimary // boolean, read-onlypointerId je brojčani identifikator samo za čitanje. Njime povezuješ događaje istog aktivnog pokazivača i razlikuješ ga od ostalih aktivnih pokazivača, primjerice od druge točke dodira. To nije trajni identifikator uređaja: iz broja ne zaključuj o vrsti uređaja i ne pretpostavljaj da će ostati isti između interakcija ili da se nikada neće ponovno upotrijebiti. U događajima koje generira preglednik -1 znači da događaj nije izazvao pokazivački uređaj, primjerice kod događaja click pokrenutog tipkovnicom.
isPrimary je logičko svojstvo samo za čitanje. Vrijednost true označuje primarni pokazivač za dani pointerType, a ne primarnu tipku. Pokazivač miša je primaran; za dodir i olovku primaran je prvi pokazivač te vrste koji postane aktivan dok nijedan drugi pokazivač iste vrste nije aktivan. Miš i dodir zato mogu istodobno imati isPrimary === true. Kad primarni dodir završi, drugi dodir koji je još aktivan ne postaje automatski primaran.
Za praćenje više gesti pri pointerdown spremi stanje u Map s ključem pointerId, potraži ga pri pointermove i ukloni pri pointerup ili pointercancel. Ako želiš pratiti samo jedan pokazivač neovisno o vrsti unosa, zapamti odabrani identifikator: filtriranje samo po isPrimary nije dovoljno. Ta svojstva pripadaju web API-ju, a ne ECMAScriptu; provjeri podršku u ciljnom okruženju.
Primjeri
<!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>Rezultat
pointerdown touch 7 true pointerdown touch 8 false pointermove touch 7 true pointermove mouse 12 true
Spremi primjer kao HTML datoteku i otvori je u pregledniku koji podržava `PointerEvent`. Izlaz se prikazuje na stranici. Identifikator `7` povezuje dva događaja dodira, `8` označuje drugi dodir, a i miš i prvi dodir imaju vrijednost `true`. Kôd čita izričito zadane vrijednosti iz sintetičkih događaja. Ne odašilje događaje i ne provjerava kako preglednik dodjeljuje vrijednosti pri stvarnom unosu.
Povezane lekcije
- JavaScript · Lekcija 35 · Srednje · Verzija: 3