元素:touchcancel 事件

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

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

  • 发生取消触控操作的硬件事件。这可能包括,例如,用户使用应用程序切换器界面或移动设备上的“主页”按钮切换应用程序。
  • 触控处于活动状态时,设备的屏幕方向发生变化。
  • 浏览器判断用户开始触控输入是意外的。例如,如果硬件支持手掌拒绝以防止用手掌放在显示屏上使用触控笔时意外触发事件,则可能会发生这种情况。
  • touch-actionCSS 属性阻止输入继续。
  • 当用户同时使用过多手指交互时,浏览器可能会对所有现有指针触发此事件(即使用户仍然触摸屏幕)。

语法

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

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

ontouchcancel = (event) => {};

事件类型

事件属性

此接口继承了其父级 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

浏览器兼容性

BCD 表格仅在浏览器中加载