CKTIS / JavaScript
PointerEvent — události ukazatele a jeho zachycení
PointerEvent sjednocuje vstup z myši, dotyku a pera. Poznejte, jak při implementaci přetahování spolupracují identifikátory ukazatelů, souřadnice výřezu, životní cyklus interakce a zachycení ukazatele.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new PointerEvent(type, options)
element.addEventListener('pointerdown', handler)
element.setPointerCapture(event.pointerId)
element.releasePointerCapture(event.pointerId)PointerEvent je rozhraní webového API prohlížeče, které dědí z MouseEvent a sjednocuje vstup z myši, dotyku a pera. Nejde o funkci konkrétní edice ECMAScriptu. Dostupnost ověřte pomocí 'PointerEvent' in window; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížeči.
PointerEvent.pointerId identifikuje aktivní ukazatel; identifikátory mohou být později znovu použity a nejsou trvalými identifikátory zařízení. PointerEvent.isPrimary označuje primární ukazatel daného typu, nikoli jediný globální ukazatel. Myš i dotyk proto mohou mít současně každý svůj primární ukazatel. PointerEvent.clientX a PointerEvent.clientY, zděděné z MouseEvent, poskytují souřadnice vzhledem k výřezu v CSS pixelech, nikoli souřadnice vůči prvku nebo počátku dokumentu.
Životní cyklus interakce zahrnuje pointerdown, pointermove a ukončení pomocí pointerup nebo pointercancel. Stav interakce vymažte i při jejím zrušení, například když prohlížeč převezme gesto. Události pointerover/pointerout a pointerenter/pointerleave popisují hranice prvků; nenahrazují ukončení interakce.
Volání element.setPointerCapture(event.pointerId) během skutečného pointerdown směruje následující události daného ukazatele do prvku, a to i mimo jeho hranice. Události gotpointercapture a lostpointercapture oznamují získání a ztrátu zachycení; element.releasePointerCapture(event.pointerId) je výslovně uvolní. K uvolnění dochází také po pointerup nebo pointercancel. Dotykový vstup může zachycení získat implicitně. Zpracujte ztrátu zachycení, aby přetahování nezůstalo aktivní.
Pro vlastní gesta nastavte odpovídající CSS touch-action ještě před zahájením interakce; samotné preventDefault() neblokuje posouvání ani přibližování výřezu. Příklad záměrně odesílá syntetické události: ověřuje vlastnosti a vyčištění stavu, ale nespouští skutečný vstup z hardwaru ani zachycení ukazatele.
Příklady
const target = document.createElement('div');
const active = new Map();
const lines = [];
for (const type of ['pointerdown', 'pointermove', 'pointerup', 'pointercancel']) {
target.addEventListener(type, (event) => {
const { pointerId, isPrimary, clientX, clientY } = event;
if (type === 'pointerdown') active.set(pointerId, true);
if (!active.has(pointerId)) return;
lines.push(`${type} ${pointerId} ${isPrimary} ${clientX},${clientY}`);
if (type === 'pointerup' || type === 'pointercancel') {
active.delete(pointerId);
}
});
}
for (const [type, clientX, clientY] of [
['pointerdown', 10, 20],
['pointermove', 15, 25],
['pointerup', 15, 25]
]) {
target.dispatchEvent(new PointerEvent(type, {
pointerId: 7, pointerType: 'touch', isPrimary: true,
clientX, clientY
}));
}
console.log(lines.join('\n'));
console.log(`active=${active.size}`);Výsledek
pointerdown 7 true 10,20 pointermove 7 true 15,25 pointerup 7 true 15,25 active=0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.