元素:touchcancel 事件

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

当一个或多个触摸点以特定于实现的方式中断时,会触发 touchcancel 事件。

将触发 touchcancel 事件的一些情况示例

  • 发生硬件事件,取消了触摸活动。这可能包括,例如,用户通过应用程序切换器界面或移动设备上的“主页”按钮切换应用程序。
  • 在触摸活动期间更改设备的屏幕方向。
  • 浏览器认为用户意外启动了触摸输入。例如,如果硬件支持掌压识别,以防止在使用触控笔时手放在显示器上意外触发事件。
  • touch-action CSS 属性可阻止输入继续。
  • 当用户同时使用过多手指进行交互时,浏览器可以为所有现有指针触发此事件(即使用户仍接触屏幕)。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

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

ontouchcancel = (event) => { }

事件类型

一个 TouchEvent。继承自 Event

Event UIEvent TouchEvent

事件属性

此接口继承自其父接口 UIEventEvent 的属性。

TouchEvent.altKey 只读

一个布尔值,指示触发触摸事件时 alt 键是否被按下。

TouchEvent.changedTouches 只读

一个 TouchList,其中包含所有 Touch 对象,这些对象代表了在之前的触摸事件和当前事件之间状态发生变化的个人接触点。

TouchEvent.ctrlKey 只读

一个布尔值,指示触发触摸事件时 control 键是否被按下。

TouchEvent.metaKey 只读

一个布尔值,指示触发触摸事件时 meta 键是否被按下。

TouchEvent.shiftKey 只读

一个布尔值,指示触发触摸事件时 shift 键是否被按下。

TouchEvent.targetTouches 只读

一个 TouchList,包含所有当前与触摸表面接触的 Touch 对象,并且这些对象也是在与事件目标相同的元素上开始触摸的。

TouchEvent.touches 只读

一个 TouchList,包含所有表示与表面接触点的 Touch 对象,无论其目标或变化状态如何。

TouchEvent.rotation 非标准 只读

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

TouchEvent.scale 非标准 只读

自事件开始以来两个手指之间的距离。表示为初始手指距离的浮点数倍。小于 1.0 的值表示向内捏合(缩小)。大于 1.0 的值表示向外张开(放大)。初始值:1.0

示例

这些事件的代码示例可在专用页面上找到:触摸事件

规范

规范
触摸事件
# event-touchcancel
触摸事件
# dom-globaleventhandlers-ontouchcancel

浏览器兼容性