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.