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

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.

Zdroje