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 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.
Version de travail Version non stable.
Pointer Events
La définition de 'releasePointerCapture' dans cette spécification.
Recommendation Définition initiale.

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 35[1] 59 (59) 10 -ms
11
? Pas de support
Fonctionnalité Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? 35[1] 29.0 (29)[2] 10 -ms
11
? Pas de support

[1] A été pris en charge dans bug 248918.

[2] Supporté avec la préférence dom.w3c_pointer_events.enabled par défaut à false (faux).

 

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : loella16
Dernière mise à jour par : loella16,