Pointer Events
pointercancel 事件会在浏览器判断可能不再会有指针事件发生,或者在触发 Element/pointerdown_event 事件后指针被用于平移、缩放或滚动来操作视口时触发。
一些会触发 pointercancel 事件的情况的例子:
- 发生了取消指针活动的硬件事件。包括用户使用应用切换界面或移动设备上的“home”键切换了应用程序。
- 设备的屏幕方向在指针活动期间发生了改变。
- 浏览器认为用户的指针输入始于意外。例如,设备支持防手掌误触功能以防止用户使用触控笔时手倚靠在屏幕上而意外触发事件。
- CSS touch-action 属性打断了继续输入。
- 用户同时使用了太多指针进行交互,浏览器会在现有全部指针上触发此事件(即使用户仍在触摸屏幕)。
[!NOTE] 在触发
pointercancel事件后,浏览器也会发送 Element/pointerout_event 事件,接着再发送 Element/pointerleave_event 事件。
语法
在 EventTarget.addEventListener 中使用此事件名称:
addEventListener("pointercancel", (event) => { })
或者,对接口的事件处理器属性赋值:
onpointercancel = (event) => { }
事件类型
PointerEvent。继承自 Event。
PointerEvent
示例
使用 addEventListener():
const para = document.querySelector("p");
para.addEventListener("pointercancel", (event) => {
console.log("指针事件取消了");
});
使用 onpointercancel 事件处理器属性(但请注意,这会替换掉之前使用 onpointercancel 添加的其他事件监听器,如存在的话):
const para = document.querySelector("p");
para.onpointercancel = (event) => {
console.log("指针事件取消了");
};
规范
浏览器兼容性
参见
- 相关事件
- Element/gotpointercapture_event
- Element/lostpointercapture_event
- Element/pointerover_event
- Element/pointerenter_event
- Element/pointerdown_event
- Element/pointermove_event
- Element/pointerup_event
- Element/pointerout_event
- Element/pointerleave_event
- Element/pointerrawupdate_event
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
