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 廃止された

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
pointercancel eventChrome 完全対応 55Edge 完全対応 ありFirefox 完全対応 59
完全対応 59
完全対応 29
無効
無効 From version 29: this feature is behind the dom.w3c_pointer_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 11
完全対応 11
完全対応 10
代替名
代替名 非標準の名前 mspointercancel を使用しています。
Opera ? Safari 未対応 なしWebView Android 完全対応 55Chrome Android 完全対応 55Firefox Android 完全対応 29
無効
完全対応 29
無効
無効 From version 29: this feature is behind the dom.w3c_pointer_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android ? Safari iOS 未対応 なしSamsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。
非標準の名前を使用しています。
非標準の名前を使用しています。

関連情報