元素:touchcancel 事件
当一个或多个触点以特定于实现的方式中断时,会触发touchcancel
事件。
一些会触发touchcancel
事件的情况示例
- 发生取消触控操作的硬件事件。这可能包括,例如,用户使用应用程序切换器界面或移动设备上的“主页”按钮切换应用程序。
- 触控处于活动状态时,设备的屏幕方向发生变化。
- 浏览器判断用户开始触控输入是意外的。例如,如果硬件支持手掌拒绝以防止用手掌放在显示屏上使用触控笔时意外触发事件,则可能会发生这种情况。
touch-action
CSS 属性阻止输入继续。- 当用户同时使用过多手指交互时,浏览器可能会对所有现有指针触发此事件(即使用户仍然触摸屏幕)。
语法
在方法(如 addEventListener()
)中使用事件名称,或设置事件处理程序属性。
js
addEventListener("touchcancel", (event) => {});
ontouchcancel = (event) => {};
事件类型
一个 TouchEvent
。继承自 Event
。
事件属性
此接口继承了其父级 UIEvent
和 Event
的属性。
TouchEvent.altKey
只读-
一个布尔值,表示在触发触摸事件时 alt 键是否被按下。
TouchEvent.changedTouches
只读-
一个
TouchList
,包含所有Touch
对象,这些对象代表了在先前触摸事件和当前触摸事件之间状态发生改变的各个接触点。 TouchEvent.ctrlKey
只读-
一个布尔值,表示在触发触摸事件时 control 键是否被按下。
TouchEvent.metaKey
只读-
一个布尔值,表示在触发触摸事件时 meta 键是否被按下。
TouchEvent.shiftKey
只读-
一个布尔值,表示在触发触摸事件时 shift 键是否被按下。
TouchEvent.targetTouches
只读-
一个
TouchList
,包含所有Touch
对象,这些对象同时满足以下条件:当前与触摸表面接触并且在与事件目标相同的元素上开始。 TouchEvent.touches
只读TouchEvent.rotation
非标准 只读-
自事件开始以来的旋转变化(以度为单位)。正值表示顺时针旋转;负值表示逆时针旋转。初始值:
0.0
。 TouchEvent.scale
非标准 只读-
自事件开始以来的两指之间的距离。以事件开始时两指之间初始距离的浮点数倍数表示。小于 1.0 的值表示向内捏合(缩小)。大于 1.0 的值表示向外拉开(放大)。初始值:
1.0
。
示例
这些事件的代码示例可在专用页面上找到:触摸事件。
规范
规范 |
---|
触摸事件 # event-touchcancel |
触摸事件 # dom-globaleventhandlers-ontouchcancel |
浏览器兼容性
BCD 表格仅在浏览器中加载