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 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 | 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).