Element.releasePointerCapture()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2020.
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'
identifiantpour 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
| Spécification |
|---|
| Pointer Events # dom-element-releasepointercapture |