Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

PointerEvent: identifikátor a primárny ukazovateľ

`pointerId` spája udalosti toho istého aktívneho ukazovateľa; `isPrimary` určuje, či je primárnym ukazovateľom svojho typu vstupu.

Verzia: Current web platform; runtime support varies

Syntax

// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId  // number, read-only
event.isPrimary  // boolean, read-only

pointerId je číselný identifikátor len na čítanie. Umožňuje spojiť udalosti toho istého aktívneho ukazovateľa a odlíšiť ho od ostatných aktívnych ukazovateľov, napríklad od druhého bodu dotyku. Nie je to trvalý identifikátor zariadenia: z čísla neodvodzuj typ zariadenia a nepredpokladaj, že hodnota zostane medzi interakciami rovnaká alebo že sa nikdy nepoužije znova. Pri udalostiach vytvorených prehliadačom znamená -1, že udalosť nevyvolalo ukazovacie zariadenie, napríklad pri click vyvolanom klávesnicou.

isPrimary je logická vlastnosť len na čítanie. Hodnota true označuje primárny ukazovateľ pre daný pointerType, nie hlavné tlačidlo. Ukazovateľ myši je primárny; pri dotyku a pere je primárny prvý ukazovateľ daného typu, ktorý sa aktivuje, keď nie je aktívny žiadny iný ukazovateľ rovnakého typu. Myš a dotykový kontakt teda môžu mať súčasne isPrimary === true. Keď sa primárny dotyk skončí, iný stále aktívny kontakt sa automaticky nestane primárnym.

Ak sleduješ viac gest, pri pointerdown ulož stav do Map s kľúčom pointerId, pri pointermove ho vyhľadaj a pri pointerup alebo pointercancel odstráň. Ak potrebuješ iba jeden ukazovateľ bez ohľadu na typ vstupu, zapamätaj si vybraný identifikátor: filtrovanie len podľa isPrimary nestačí. Tieto vlastnosti patria do webového API, nie do ECMAScriptu; over si podporu v cieľovom prostredí.

Príklady

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

Výsledok

pointerdown touch 7 true
pointerdown touch 8 false
pointermove touch 7 true
pointermove mouse 12 true

Ulož príklad ako súbor HTML a otvor ho v prehliadači s podporou `PointerEvent`. Výstup sa zobrazí na stránke. Identifikátor `7` spája dve dotykové udalosti, `8` označuje iný kontakt a myš aj prvý kontakt majú hodnotu `true`. Kód číta výslovne zadané hodnoty zo syntetických udalostí. Udalosti neodosiela ani netestuje, ako prehliadač priraďuje hodnoty pri skutočnom vstupe.

Súvisiace lekcie

  • JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3

Zdroje