HTMLElement: pointercancel イベント

pointercancel イベントは、これ以上ポインタイベントがないとブラウザーが判断したとき、または pointerdown イベントが発生した後に、パン、ズーム、スクロールによってビューポートを操作するためにポインタを使用する場合に発生します。

バブリング あり
キャンセル 不可
インターフェイス PointerEvent
イベントハンドラプロパティ onpointercancel

pointercancel イベントを引き起こす状況の例

  • ポインタの活動をキャンセルするハードウェアイベントが発生した。 これには、例えば、アプリ切り替えインターフェイスやモバイルデバイスの「ホーム」ボタンを使用したユーザーのアプリ切り替えが含まれる場合があります。
  • ポインタがアクティブなときに、デバイスの画面の向きが変わった。
  • ブラウザーが、ユーザーが誤ってポインタ入力を開始したと判断した。 これは、例えば、スタイラスを使用しているときにディスプレイ上に手を置いて誤ってトリガしないように、ハードウェアが手のひら拒否をサポートしている場合に発生する可能性があります。
  • touch-action CSS プロパティが、入力を続行しないようにした。

pointercancel イベントが発生した後、ブラウザーは pointerout とそれに続く pointerleave も送信します。

addEventListener() を使用する場合

const para = document.querySelector('p');

para.addEventListener('pointercancel', (event) => {
  console.log('ポインタイベントがキャンセルされた');
});

onpointercancel イベントハンドラプロパティを使用する場合

const para = document.querySelector('p');

para.onpointercancel = (event) => {
  console.log('ポインタイベントがキャンセルされた');
};

仕様

仕様 状態
Pointer Events 廃止

ブラウザーの互換性

BCD tables only load in the browser

関連情報