元素:touchcancel 事件
当一个或多个触摸点以特定于实现的方式中断时,会触发 touchcancel 事件。
将触发 touchcancel 事件的一些情况示例
- 发生硬件事件,取消了触摸活动。这可能包括,例如,用户通过应用程序切换器界面或移动设备上的“主页”按钮切换应用程序。
- 在触摸活动期间更改设备的屏幕方向。
- 浏览器认为用户意外启动了触摸输入。例如,如果硬件支持掌压识别,以防止在使用触控笔时手放在显示器上意外触发事件。
touch-actionCSS 属性可阻止输入继续。- 当用户同时使用过多手指进行交互时,浏览器可以为所有现有指针触发此事件(即使用户仍接触屏幕)。
语法
在诸如 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 |
浏览器兼容性
加载中…