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

CKTIS / JavaScript

PointerEvent — udalosti ukazovateľa a jeho zachytenie

PointerEvent zjednocuje vstup z myši, dotyku a pera. Zistite, ako pri implementácii ťahania spolupracujú identifikátory ukazovateľa, súradnice výrezu, životný cyklus interakcie a zachytenie ukazovateľa.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new PointerEvent(type, options)
element.addEventListener('pointerdown', handler)
element.setPointerCapture(event.pointerId)
element.releasePointerCapture(event.pointerId)

PointerEvent je rozhranie webového API prehliadača, ktoré dedí z MouseEvent a zjednocuje vstup z myši, dotyku a pera. Nie je to funkcia konkrétnej edície ECMAScriptu. Dostupnosť overte pomocou 'PointerEvent' in window; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.

PointerEvent.pointerId identifikuje aktívny ukazovateľ; identifikátory sa môžu neskôr opätovne použiť a nie sú trvalými identifikátormi zariadení. PointerEvent.isPrimary označuje primárny ukazovateľ daného typu, nie jediný globálny ukazovateľ. Myš aj dotyk preto môžu mať súčasne každý svoj primárny ukazovateľ. PointerEvent.clientX a PointerEvent.clientY, zdedené z MouseEvent, poskytujú súradnice vzhľadom na výrez v CSS pixeloch, nie súradnice vzhľadom na prvok alebo začiatok dokumentu.

Životný cyklus interakcie zahŕňa pointerdown, pointermove a ukončenie pomocou pointerup alebo pointercancel. Stav interakcie vymažte aj pri jej zrušení, napríklad keď prehliadač prevezme gesto. Udalosti pointerover/pointerout a pointerenter/pointerleave opisujú hranice prvkov; nenahrádzajú ukončenie interakcie.

Volanie element.setPointerCapture(event.pointerId) počas skutočného pointerdown smeruje nasledujúce udalosti daného ukazovateľa do prvku, aj keď je mimo jeho hraníc. Udalosti gotpointercapture a lostpointercapture oznamujú získanie a stratu zachytenia; element.releasePointerCapture(event.pointerId) ho výslovne uvoľní. K uvoľneniu dôjde aj po pointerup alebo pointercancel. Dotykový vstup môže získať zachytenie implicitne. Ošetrite stratu zachytenia, aby ťahanie nezostalo aktívne.

Pri vlastných gestách nastavte príslušné CSS touch-action ešte pred začiatkom interakcie; samotné preventDefault() neblokuje posúvanie ani približovanie výrezu. Príklad zámerne odosiela syntetické udalosti: kontroluje vlastnosti a vyčistenie stavu, ale nespúšťa skutočný vstup z hardvéru ani zachytenie ukazovateľa.

Prí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ýsledok

pointerdown 7 true 10,20
pointermove 7 true 15,25
pointerup 7 true 15,25
active=0

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje