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 July 2020.

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

構文

js
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>

仕様書

Specification
Pointer Events
# dom-element-haspointercapture

ブラウザーの互換性

BCD tables only load in the browser

関連情報