TouchEvent

TouchEvent() (en-US)

创建一个TouchEvent对象。

TouchEvent的属性继承了 UIEvent 和 Event。

TouchEvent.altKey 只读

布尔值，指明触摸事件触发时，键盘 alt 键是否被按下。

TouchEvent.changedTouches 只读

一个 TouchList 对象，包含了代表所有从上一次触摸事件到此次事件过程中，状态发生了改变的触点的 Touch 对象。

TouchEvent.ctrlKey 只读

布尔值，指明触摸事件触发时，键盘 ctrl 键是否被按下。

TouchEvent.metaKey 只读

布尔值，指明触摸事件触发时，键盘 meta 键（Wikipedia - meta Key）是否被按下。

TouchEvent.shiftKey 只读

布尔值，指明触摸事件触发时，键盘 shift 键是否被按下。

TouchEvent.targetTouches 只读

一个 TouchList 对象，是包含了如下触点的 Touch 对象：触摸起始于当前事件的目标 element 上，并且仍然没有离开触摸平面的触点。

TouchEvent.touches 只读

一 个 TouchList 对象，包含了所有当前接触触摸平面的触点的 Touch 对象，无论它们的起始于哪个 element 上，也无论它们状态是否发生了变化。

为了区别触摸相关的状态改变，存在多种类型的触摸事件。可以通过检查触摸事件的 TouchEvent.type 属性来确定当前事件属于哪种类型

当用户在触摸平面上放置了一个触点时触发。事件的目标 element 将是触点位置上的那个目标 element

当一个触点被用户从触摸平面上移除（即用户的一个手指或手写笔离开触摸平面）时触发。当触点移出触摸平面的边界时也将触发。例如用户将手指划出屏幕边缘。

事件的目标 element 与触发 touchstart 事件的目标 element 相同，即使 touchend 事件触发时，触点已经移出了该 element 。

已经被从触摸平面上移除的触点，可以在 changedTouches 属性定义的 TouchList 中找到。

当用户在触摸平面上移动触点时触发。事件的目标 element 和触发 touchstart 事件的目标 element 相同，即使当 touchmove 事件触发时，触点已经移出了该 element 。

当触点的半径、旋转角度以及压力大小发生变化时，也将触发此事件。

当触点由于某些原因被中断时触发。有几种可能的原因如下（具体的原因根据不同的设备和浏览器有所不同）：

• 由于某个事件出现而取消了触摸：例如触摸过程被弹窗打断。
• 触点离开了文档窗口，而进入了浏览器的界面元素、插件或者其他外部内容区域。
• 当用户产生的触点个数超过了设备支持的个数，从而导致 TouchList 中最早的 Touch 对象被取消。

很值得注意的是，在很多情况下，触摸事件和鼠标事件会一起触发（以使非触摸专用的代码仍然可以与用户交互）。如果你要使用触摸事件，你可以使用 preventDefault() 来取消鼠标事件。

但 Chrome 是例外，从版本 56（桌面版、安卓版和安卓 webview）开始，Chrome 中 touchstart and touchmove 的默认值就是 true，没有必要调用 preventDefault()。如果要重写这个行为，简单地将 passive 设置成 false 就行。这样设置可以阻止监听器在用户滚动时停止页面渲染。Google Developer 有一个简单的演示。

GlobalEventHandlers.ontouchstart 实验性

使用一个 global event handler 处理touchstart 事件。

GlobalEventHandlers.ontouchend (en-US) 实验性

使用一个 global event handler 处理 touchend 事件。

GlobalEventHandlers.ontouchmove 实验性

使用一个 global event handler 处理 touchmove 事件。

GlobalEventHandlers.ontouchcancel 实验性

使用一个 global event handler 处理 touchcancel 事件。

请看 example on the main Touch events article.

• Touch Events Overview
• GestureEvent
• MSGestureEvent