Element:touchcancel 事件

touchcancel 事件在触点被中断时触发,中断方式基于特定实现而有所不同(例如,创建了太多的触点)。

语法

在类似 addEventListener() 这样的方法中使用事件名称,或设置事件处理器属性。

js
addEventListener("touchcancel", (event) => {});

ontouchcancel = (event) => {};

事件类型

事件属性

此接口从其父接口 UIEventEvent 继承属性。

TouchEvent.altKey 只读

一个布尔值,表示在事件触发时 Alt 键是否被按下。

TouchEvent.changedTouches 只读

一个包含所有的 Touch 对象的 TouchList,这些 Touch 对象表示在前一个 touch 事件和当前的事件之间,状态发生变化的独立触点。

TouchEvent.ctrlKey 只读

一个布尔值,表示在事件触发时控制键是否被按下。

TouchEvent.metaKey 只读

一个布尔值,表示在事件触发时 Meta 键是否被按下。

TouchEvent.shiftKey 只读

一个布尔值,表示在事件触发时 Shift 键是否被按下。

TouchEvent.targetTouches 只读

一个包含所有的 Touch 对象的 TouchList,这些 Touch 对象表示当前与触摸表面接触的触点,且触点起始于事件发生的目标元素。

TouchEvent.touches 只读

一个包含所有的 Touch 对象的 TouchList,这些 Touch 对象表示当前与表面接触的触点(不论事件目标或状态变化)。

TouchEvent.rotation 非标准 只读

自事件开始以来的旋转角度变化(以度为单位)。正值表示顺时针旋转;负值表示逆时针旋转。初始值为 0.0

TouchEvent.scale 非标准 只读

自事件开始以来,两个数值之间的距离(缩放倍数)。表示事件开始至现在,触点距离的缩放倍数(浮点数)。小于 1.0 表示向内收缩(缩小),大于 1.0 表示向外松开(放大)。初始值为 1.0

示例

这些事件的代码示例可在这个专用页面查看:Touch 事件

规范

Specification
Touch Events
# event-touchcancel
Touch Events
# dom-globaleventhandlers-ontouchcancel

浏览器兼容性

BCD tables only load in the browser

参见