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