当浏览器认为不再会有更多的指针事件, 或者在 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
参见
- Related events
onpointercancel
event handler property- This event on
Document
targets:pointercancel
event