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.