Document: pointercancel イベント

pointercancel イベントは、ブラウザーがもうポインターイベントが存在しないと判断したとき、または pointerdown イベントが発生した後で、ポインターがビューポートのパン、ズーム、スクロールを操作するために使用されたときに発生します。

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

pointercancel イベントが発生する状況の例をいくつか示します。

  • ポインターの操作を中止するハードウェアイベントが発生した場合。例えば、アプリケーションスイッチャーインターフェイスやモバイル端末の「ホーム」ボタンを使用してアプリケーションを切り替えた場合などです。
  • ポインターが活動中に端末の画面の向きが変化した場合。
  • ユーザーが突然、ポインターの入力を始めたとブラウザーが判断した場合。これが発生するのは、例えば、スタイラスを使用中に画面上で手が反応するのを防ぐために掌を除外して予期せずイベントを起動することを防ぐことに、ハードウェアが対応している場合などです。
  • CSS の touch-action プロパティが、入力の継続を防止している場合。

pointercancel イベントの発生後、ブラウザーは pointerout イベントと、続いて pointerleave イベントを送信します。

addEventListener() の使用例:

document.addEventListener('pointercancel', (event) => {
  console.log('Pointer event cancelled')
});

onpointercancel イベントハンドラープロパティの使用例:

document.onpointercancel = (event) => {
  console.log('Pointer event cancelled')
};

仕様書

仕様書 状態
Pointer Events 勧告

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 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 完全対応 55Edge Mobile 完全対応 ありFirefox 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 ?

凡例

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

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09
最終更新者: mfuji09,