Element: hasPointerCapture() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2020年7月⁩.

hasPointerCapture() は Element インターフェイスのメソッドで、それを呼び出した要素が、指定されたポインター ID によって識別されるポインターに対するポインターキャプチャを持つかどうかを示します。

構文

hasPointerCapture(pointerId)

引数

pointerId: PointerEvent オブジェクトの pointerId。

返値

論理値です。指定されたポインター ID で識別されるポインターのポインターキャプチャが要素にある場合は true、ない場合は false を返します。

例

html

<html lang="ja">
  <script>
    function downHandler(ev) {
      const el = document.getElementById("target");
      // 要素 'target' はそれ以上のイベントを受信/キャプチャします
      el.setPointerCapture(ev.pointerId);

      // …

      // 要素にまだポインターキャプチャがあるかどうかを確認します
      let pointerCap = el.hasPointerCapture(ev.pointerId);
      if (pointerCap) {
        // まだポインターキャプチャがあります
      } else {
        // おっと、ポインターキャプチャを失いました！
      }
    }

    function init() {
      const el = document.getElementById("target");
      el.onpointerdown = downHandler;
    }
  </script>
  <body onload="init();">
    <div id="target">この要素をポインターでタッチします。</div>
  </body>
</html>