KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

PointerEvent — pointergebeurtenissen en vastleggen

PointerEvent verenigt invoer van muis, aanraking en pen. Ontdek hoe pointer-ID's, viewportcoördinaten, de levenscyclus van interacties en pointer capture samenwerken bij het implementeren van slepen.

Versie: 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 is een browser-Web-API-interface die overerft van MouseEvent en invoer van muis, aanraking en pen verenigt. Het is geen functie van een bepaalde ECMAScript-editie. Controleer de beschikbaarheid met 'PointerEvent' in window; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.

PointerEvent.pointerId identificeert een actieve pointer; ID's kunnen later opnieuw worden gebruikt en zijn geen permanente apparaat-ID's. PointerEvent.isPrimary geeft de primaire pointer van zijn type aan, niet één wereldwijde pointer. Muis en aanraking kunnen dus tegelijk elk een primaire pointer hebben. PointerEvent.clientX en PointerEvent.clientY, overgeërfd van MouseEvent, geven viewportrelatieve coördinaten in CSS-pixels, geen elementgebonden coördinaten of coördinaten ten opzichte van de oorsprong van het document.

De interactiecyclus omvat pointerdown, pointermove en beëindiging via pointerup of pointercancel. Wis de interactiestatus ook bij annulering, bijvoorbeeld wanneer de browser een gebaar overneemt. pointerover/pointerout en pointerenter/pointerleave beschrijven elementgrenzen; ze vervangen het beëindigen van de interactie niet.

Als element.setPointerCapture(event.pointerId) tijdens een echte pointerdown wordt aangeroepen, worden volgende gebeurtenissen voor die pointer naar het element gestuurd, ook buiten de grenzen ervan. gotpointercapture en lostpointercapture melden het verkrijgen en verliezen van de capture; element.releasePointerCapture(event.pointerId) geeft deze expliciet vrij. Vrijgave volgt ook op pointerup of pointercancel. Aanraakinvoer kan impliciet capture krijgen. Verwerk verlies van capture om te voorkomen dat een sleepactie actief blijft.

Declareer voor aangepaste gebaren de juiste CSS touch-action voordat de interactie begint; preventDefault() alleen blokkeert het pannen en zoomen van de viewport niet. Het voorbeeld verstuurt bewust synthetische gebeurtenissen: het controleert eigenschappen en het opruimen van de status, maar veroorzaakt geen echte hardware-invoer of pointer capture.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen