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