Element.releasePointerCapture()

Relâche (arrête) la capture de pointeur précédemment définie pour un pointer (PointerEvent) spécifique.

Voir la méthode Element.setPointerCapture() pour une description de pointer capture et la façon de le définir pour un élément particulier.

Syntaxe

targetElement.releasePointerCapture(pointerId);

Arguments

pointerId

L'identifiant (en-US) pour un pointer event.

Valeur retournée

Si pointerId ne correspond à aucun pointeur actif, cette méthode renvoie void (vide) et déclenche une DOMException avec le nom InvalidPointerId.

Exemple

<html>
<script>
function downHandler(ev) {
 var el=document.getElementById("target");
 // L'élément "target" va recevoir/capturer d'autres évènements
 el.setPointerCapture(ev.pointerId);
}
function cancelHandler(ev) {
 var el=document.getElementById("target");
 // Relâche la capture du pointeur
 el.releasePointerCapture(ev.pointerId);
}
function init() {
 var el=document.getElementById("target");
 // Enregistre les gestionnaires du pointeur
 el.onpointerdown = downHandler;
 el.onpointercancel = cancelHandler;
}
</script>
<body onload="init();">
<div id="target"> Touch me ... </div>
</body>
</html>

Spécifications

Spécification Statut Commentaire
Pointer Events – Level 2
La définition de 'releasePointerCapture' dans cette spécification.
Recommendation Version non stable.
Pointer Events
La définition de 'releasePointerCapture' dans cette spécification.
Obsolete Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi