Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

PointerEvent — događaji pokazivača i hvatanje

PointerEvent objedinjuje unos mišem, dodirom i olovkom. Saznajte kako identifikatori pokazivača, koordinate prikaza, životni ciklus interakcije i hvatanje pokazivača zajedno omogućuju implementaciju povlačenja.

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

Sintaksa

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

PointerEvent je sučelje web API-ja preglednika koje nasljeđuje MouseEvent i objedinjuje unos mišem, dodirom i olovkom. Nije značajka određene verzije ECMAScripta. Dostupnost provjerite pomoću 'PointerEvent' in window; prisutnost Node 24 u repozitoriju ne dokazuje podršku preglednika.

PointerEvent.pointerId identificira aktivni pokazivač; identifikatori se kasnije mogu ponovno upotrijebiti i nisu trajni identifikatori uređaja. PointerEvent.isPrimary označava primarni pokazivač svoje vrste, a ne jedan jedini globalni pokazivač. Miš i dodir zato istodobno mogu imati svaki svoj primarni pokazivač. PointerEvent.clientX i PointerEvent.clientY, naslijeđeni iz MouseEvent, daju koordinate u odnosu na prikaz u CSS pikselima, a ne koordinate u odnosu na element ili ishodište dokumenta.

Životni ciklus interakcije obuhvaća pointerdown, pointermove i završetak pomoću pointerup ili pointercancel. Očistite stanje interakcije i pri otkazivanju, primjerice kad preglednik preuzme upravljanje gestom. pointerover/pointerout i pointerenter/pointerleave opisuju granice elemenata; ne zamjenjuju završetak interakcije.

Poziv element.setPointerCapture(event.pointerId) tijekom stvarnog događaja pointerdown usmjerava sljedeće događaje tog pokazivača na element, čak i izvan njegovih granica. Događaji gotpointercapture i lostpointercapture označavaju dobivanje i gubitak hvatanja; element.releasePointerCapture(event.pointerId) izričito ga otpušta. Otpuštanje slijedi i nakon pointerup ili pointercancel. Dodir može implicitno dobiti hvatanje. Obradite gubitak hvatanja kako povlačenje ne bi ostalo aktivno.

Za prilagođene geste postavite odgovarajući CSS touch-action prije početka interakcije; sam preventDefault() ne sprječava pomicanje ni zumiranje prikaza. Primjer namjerno šalje sintetičke događaje: provjerava svojstva i čišćenje stanja, ali ne pokreće stvarni unos hardvera ni hvatanje pokazivača.

Primjeri

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}`);

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori