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
js
targetElement.releasePointerCapture(pointerId);
Arguments
- pointerId
-
L'
identifiant
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
<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