KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.releasePointerCapture() — pointer-capture vrijgeven

releasePointerCapture(pointerId) geeft de vastlegging van een specifieke pointer door een element vrij en herstelt de normale, op positie gebaseerde bepaling van het gebeurtenisdoel.

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

element.releasePointerCapture(pointerId)

Element.releasePointerCapture geeft de vastlegging vrij van de pointer die wordt aangeduid door pointerId, meestal verkregen uit een gebeurtenis. De methode retourneert undefined. Door de vastlegging worden gebeurtenissen naar het element gestuurd, ook wanneer de pointer zich buiten de grenzen ervan bevindt; na het vrijgeven wordt de normale, op positie gebaseerde doelbepaling hersteld. Fysiek contact of het indrukken van een knop wordt hierdoor niet beëindigd.

Een inactieve identifier veroorzaakt een DOMException met de naam NotFoundError. Bij een actieve pointer doet de methode niets als dit element die niet heeft vastgelegd. hasPointerCapture(pointerId) controleert de status van een in afwachting zijnde vastlegging. Door het vrijgeven wordt die status onmiddellijk gewist, maar lostpointercapture hoeft niet synchroon te worden verzonden.

De browser geeft de vastlegging ook vrij na pointerup of pointercancel. Het voorbeeld geeft die eerder vrij, bij de eerste beweging na het indrukken. Dit is een browser-API voor Pointer Events, geen ECMAScript-functie; Node 24 toont niet aan dat deze beschikbaar is. Controleer de ondersteuning in de doelbrowsers.

Voorbeelden

const pad = document.createElement('button');
pad.textContent = 'Press and move';
pad.style.touchAction = 'none';
document.body.append(pad);

pad.addEventListener('pointerdown', (event) => {
  pad.setPointerCapture(event.pointerId);
});

pad.addEventListener('pointermove', (event) => {
  if (pad.hasPointerCapture(event.pointerId)) {
    const result = pad.releasePointerCapture(event.pointerId);
    console.log(result, pad.hasPointerCapture(event.pointerId));
  }
});

Resultaat

undefined false

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