Element: hasPointerCapture()-Methode

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.

Die Methode hasPointerCapture() des Element-Interfaces prüft, ob das Element, auf dem sie aufgerufen wird, Pointer Capture für den Zeiger mit der angegebenen Zeiger-ID hat.

Syntax

js
hasPointerCapture(pointerId)

Parameter

pointerId

Die pointerId eines PointerEvent-Objekts.

Rückgabewert

Ein boolescher Wert — true, wenn das Element Pointer Capture für den durch die angegebene Zeiger-ID identifizierten Zeiger hat, false nicht.

Beispiele

html
<html lang="en">
  <script>
    function downHandler(ev) {
      const el = document.getElementById("target");
      // Element 'target' will receive/capture further events
      el.setPointerCapture(ev.pointerId);

      // …

      // Check whether element still has pointer capture
      let pointerCap = el.hasPointerCapture(ev.pointerId);
      if (pointerCap) {
        // We've still got pointer capture
      } else {
        // oops, we've lost pointer capture!
      }
    }

    function init() {
      const el = document.getElementById("target");
      el.onpointerdown = downHandler;
    }
  </script>
  <body onload="init();">
    <div id="target">Touch this element with a pointer.</div>
  </body>
</html>

Spezifikationen

Specification
Pointer Events
# dom-element-haspointercapture

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch