Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

PointerEvent: identifikátor a primární ukazatel

`pointerId` propojuje události téhož aktivního ukazatele; `isPrimary` říká, zda je tento ukazatel primární pro svůj typ vstupu.

Verze: Current web platform; runtime support varies

Syntaxe

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

pointerId je číselný identifikátor pouze pro čtení. Umožňuje spojit události téhož aktivního ukazatele a odlišit jej od ostatních aktivních ukazatelů, například od druhého bodu dotyku. Nejde o trvalý identifikátor zařízení: z čísla neodvozuj typ zařízení a nepředpokládej, že hodnota zůstane stejná mezi interakcemi nebo že se nikdy nepoužije znovu. U událostí vytvořených prohlížečem znamená -1, že událost nevyvolalo ukazovací zařízení, například u click vyvolaného klávesnicí.

isPrimary je logická vlastnost pouze pro čtení. Hodnota true označuje primární ukazatel pro daný pointerType, nikoli hlavní tlačítko. Ukazatel myši je primární; u dotyku a pera je primární první ukazatel daného typu, který se aktivuje, když není aktivní žádný jiný ukazatel stejného typu. Myš a dotykový kontakt tedy mohou mít současně isPrimary === true. Když primární dotyk skončí, jiný dosud aktivní kontakt se automaticky nestane primárním.

Chceš-li sledovat více gest, při pointerdown ulož stav do Map s klíčem pointerId, při pointermove jej vyhledej a při pointerup nebo pointercancel jej odstraň. Pokud chceš sledovat jen jeden ukazatel bez ohledu na typ vstupu, zapamatuj si zvolený identifikátor: samotný filtr podle isPrimary nestačí. Tyto vlastnosti patří do webového API, nikoli do ECMAScriptu; ověř podporu v cílovém prostředí.

Pří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ýsledek

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

Ulož příklad jako soubor HTML a otevři ho v prohlížeči s podporou `PointerEvent`. Výstup se zobrazí na stránce. Identifikátor `7` spojuje dvě dotykové události, `8` označuje jiný kontakt a myš i první kontakt mají hodnotu `true`. Kód čte výslovně zadané hodnoty ze syntetických událostí. Události nerozesílá ani netestuje, jak prohlížeč přiděluje hodnoty při skutečném vstupu.

Související lekce

  • JavaScript · Lekce 35 · Středně pokročilá · Verze: 3

Zdroje