Document: pointercancel イベント

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

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

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

例

addEventListener() の使用例:

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

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

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

仕様書

ブラウザーの対応

関連情報

• 関連イベント
  • gotpointercapture
  • lostpointercapture
  • pointerover
  • pointerenter
  • pointerdown
  • pointermove
  • pointerup
  • pointerout
  • pointerleave
• GlobalEventHandlers.onpointercancel イベントハンドラープロパティ
• HTMLElement を対象としたこのイベント: pointercancel イベント