CKTIS / JavaScript
PointerEvent — dogodki kazalca in zajem
PointerEvent poenoti vhod z miško, dotikom in pisalom. Spoznajte, kako se identifikatorji kazalcev, koordinate vidnega polja, življenjski cikel interakcije in zajem kazalca povezujejo pri izvedbi vlečenja.
Različica: 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 vmesnik brskalniškega spletnega API-ja, ki deduje od MouseEvent in poenoti vhod miške, dotika in pisala. Ni funkcija določene izdaje ECMAScripta. Razpoložljivost preverite z 'PointerEvent' in window; prisotnost Node 24 v repozitoriju ne dokazuje podpore brskalnika.
PointerEvent.pointerId označuje aktivni kazalec; identifikatorji se lahko pozneje znova uporabijo in niso trajni identifikatorji naprav. PointerEvent.isPrimary označuje primarni kazalec svoje vrste, ne enega samega globalnega kazalca. Miška in dotik imata zato lahko hkrati vsak svoj primarni kazalec. PointerEvent.clientX in PointerEvent.clientY, podedovana od MouseEvent, podajata koordinate glede na vidno polje v slikovnih pikah CSS, ne pa koordinat glede na element ali izhodišče dokumenta.
Življenjski cikel interakcije vključuje pointerdown, pointermove in zaključek z pointerup ali pointercancel. Stanje interakcije počistite tudi ob preklicu, na primer ko brskalnik prevzame upravljanje kretnje. pointerover/pointerout in pointerenter/pointerleave opisujejo meje elementov; ne nadomestijo zaključka interakcije.
Klic element.setPointerCapture(event.pointerId) med resničnim dogodkom pointerdown usmeri nadaljnje dogodke tega kazalca na element, tudi zunaj njegovih meja. gotpointercapture in lostpointercapture sporočata pridobitev in izgubo zajema; element.releasePointerCapture(event.pointerId) ga izrecno sprosti. Sprostitev sledi tudi po pointerup ali pointercancel. Dotik lahko zajem pridobi implicitno. Obravnavajte izgubo zajema, da vlečenje ne ostane aktivno.
Za lastne kretnje določite ustrezen CSS touch-action pred začetkom interakcije; sam preventDefault() ne prepreči premikanja in povečave vidnega polja. Primer namenoma sproža sintetične dogodke: preveri lastnosti in čiščenje stanja, ne sproži pa resničnega vnosa strojne opreme ali zajema kazalca.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.