Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

PointerEvent: identifikator in primarni kazalec

`pointerId` povezuje dogodke istega aktivnega kazalca; `isPrimary` pove, ali je ta kazalec primarni za svojo vrsto vnosa.

Različica: 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 številski identifikator, ki ga lahko samo bereš. Z njim povežeš dogodke istega aktivnega kazalca in ga ločiš od drugih aktivnih kazalcev, na primer od druge točke dotika. To ni trajni identifikator naprave: iz številke ne sklepaj o vrsti naprave in ne predpostavljaj, da bo identifikator ostal enak med interakcijami ali da ne bo nikoli ponovno uporabljen. Pri dogodkih, ki jih ustvari brskalnik, -1 pomeni, da dogodka ni sprožila kazalna naprava, na primer pri click, sproženem s tipkovnico.

isPrimary je logična lastnost, ki jo lahko samo bereš. Vrednost true označuje primarni kazalec za dani pointerType, ne primarnega gumba. Miškin kazalec je primarni; pri dotiku in peresu je primarni prvi kazalec te vrste, ki postane aktiven, ko ni aktiven noben drug kazalec iste vrste. Miška in dotik imata zato lahko hkrati isPrimary === true. Ko se primarni dotik konča, drug še aktiven dotik ne postane samodejno primarni.

Za sledenje več gestam ob pointerdown shrani stanje v Map s ključem pointerId, ob pointermove ga poišči, ob pointerup ali pointercancel pa ga izbriši. Če želiš slediti samo enemu kazalcu ne glede na vrsto vnosa, si zapomni izbrani identifikator: filtriranje samo po isPrimary ne zadošča. Ti lastnosti sta del spletnega API-ja, ne ECMAScripta; preveri podporo v ciljnem okolju.

Primeri

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

Shrani primer kot datoteko HTML in jo odpri v brskalniku, ki podpira `PointerEvent`. Izpis se prikaže na strani. Identifikator `7` povezuje dva dogodka dotika, `8` označuje drug dotik, tako miška kot prvi dotik pa imata vrednost `true`. Koda prebere izrecno nastavljene vrednosti sintetičnih dogodkov. Dogodkov ne pošilja in ne preverja, kako brskalnik dodeli vrednosti pri dejanskem vnosu.

Povezane lekcije

  • JavaScript · Lekcija 35 · Srednja · Različica: 3

Viri