Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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
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>
<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 |
Compatibilité des navigateurs
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Voir aussi
Aider à améliorer MDN
Cette page a été modifiée le par les contributeur·ice·s du MDN.