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 unpointer 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
| Specification |
|---|
| Pointer Events # dom-element-releasepointercapture |
Compatibilité des navigateurs
BCD tables only load in the browser