Element.releasePointerCapture()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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'identifiant pour un pointer 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

Voir aussi