Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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-only

pointerId 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

Izvori