CKTIS / JavaScript
Element.releasePointerCapture() — libérer la capture du pointeur
releasePointerCapture(pointerId) libère la capture d’un pointeur particulier par un élément et rétablit le ciblage normal des événements en fonction de leur position.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.releasePointerCapture(pointerId)Element.releasePointerCapture libère la capture du pointeur identifié par pointerId, généralement obtenu à partir d’un événement. La méthode renvoie undefined. La capture dirige les événements vers un élément même lorsque le pointeur se trouve en dehors de ses limites ; sa libération rétablit le ciblage normal en fonction de la position. Elle ne met pas fin au contact physique ni à une pression sur un bouton.
Un identifiant inactif déclenche une DOMException nommée NotFoundError. Pour un pointeur actif, la méthode ne fait rien si cet élément n’en a pas la capture. hasPointerCapture(pointerId) vérifie l’état de capture en attente ; la libération efface immédiatement cet état, mais lostpointercapture n’est pas nécessairement déclenché de manière synchrone.
Le navigateur libère également la capture après pointerup ou pointercancel. L’exemple la libère plus tôt, au premier mouvement après la pression. Il s’agit d’une API Pointer Events du navigateur, et non d’une fonctionnalité ECMAScript ; Node 24 ne prouve pas qu’elle est disponible. Vérifiez sa prise en charge dans les navigateurs ciblés.
Exemples
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));
}
});Résultat
undefined false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.