HTMLElement: pointercancel event

当浏览器认为不再会有更多的指针事件, 或者在 pointerdown 事件触发之后用户滚动或者缩放窗口,pointercancel 事件被触发。

Bubbles Yes
Cancelable No
Interface PointerEvent
Event handler property onpointercancel

常见需要 pointercancel 事件的地方:

  • 用户在使用指针设备时按了硬件按钮,如用户打开任务切换界面或者按下手机的“Home”键;
  • 指针正在使用时屏幕旋转;
  • 浏览器认为用户不小心按了指针设备。例如,用户把手掌放在触摸屏上,触发了手掌检测;
  • touch-action CSS 属性不允许继续输入。

在 pointercancel 事件触发后,浏览器会按顺序发送 pointerout 以及 pointerleave

示例

使用 addEventListener():

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

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

使用 onpointercancel 事件句柄属性:

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

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

Specifications

Specification Status
Pointer Events Obsolete

浏览器兼容性

BCD tables only load in the browser

参见