Touch - 表示触摸感应设备上的单个接触点

Touch 接口表示触摸感应设备上的单个接触点。接触点通常是手指或触控笔，设备可以是触摸屏或触控板。

Touch.radiusX，Touch.radiusY 和 Touch.rotationAngle 描述了用户与屏幕之间的接触区域，即_触摸区域_。在处理不精确的指点设备（例如手指）时，这可能会有所帮助。设置这些值以描述一个椭圆，该椭圆尽可能与整个接触区域（例如用户的指尖）匹配。

注意： 许多属性的值取决于硬件；如果设备无法检测施加在表面上的压力大小，则 force 将始终为 0. radiusX 和 radiusY 可能也是如此。如果硬件仅报告单个点，则这些值为 1。

构造函数

Touch()

创建一个 Touch 对象。

属性

此接口没有父级，因此不会继承或实现任何其他属性。

基础属性

Touch.identifier 只读

返回此 Touch 对象的唯一标识符。给定的触摸点（例如，用手指）在其围绕表面的移动持续时间内将具有相同的标识符。这样可以确保您一直在跟踪相同的触摸。

Touch.screenX 只读

返回触摸点相对于屏幕左边缘的 X 坐标。

Touch.screenY 只读

返回触摸点相对于屏幕顶部边缘的 Y 坐标。

Touch.clientX 只读

返回触摸点相对于浏览器视口左边缘的 X 坐标，不包括任何滚动偏移量。

Touch.clientY 只读

返回相对于浏览器视口顶部边缘的触摸点的 Y 坐标，不包括任何滚动偏移量。

Touch.pageX 只读

返回触摸点相对于文档左边缘的 X 坐标。与 clientX 不同，此值包括水平滚动偏移量（如果有）。

Touch.pageY 只读

返回相对于文档顶部的触摸点的 Y 坐标。与 clientY 不同，此值包括垂直滚动偏移量（如果有）。

Touch.target 只读

返回接触点在最初放置在表面上时在其上开始的 Element。即使此后接触点已移出该元素的交互区域甚至从文档中移除，该属性仍不变。

接触面积

Touch.radiusX 只读

返回最接近外接屏幕的椭圆的 X 半径。该值的像素单位与 screenX 相同。

Touch.radiusY 只读

返回最接近外接屏幕的椭圆的 Y 半径。该值的像素单位与 screenY 相同。

Touch.rotationAngle 只读

返回由 radiusX 和 radiusY 描述的椭圆必须顺时针旋转的角度（以度为单位），以最精确地覆盖用户与曲面之间的接触区域。

Touch.force只读

返回一个 float，表示用户施加到表面的压力值，介于 0.0（无压力）和 1.0（最大压力）之间。

方法

该接口没有方法，也没有父级，并且不继承或实现任何方法。

规范

规范	状态	备注
Touch Events – Level 2 Touch 的定义	草稿	添加了 radiusX，radiusY，rotationAngle，force 属性以及 Touch() 构造函数。
Touch Events Touch 的定义	推荐	初始定义。

桌面浏览器兼容性

移动浏览器兼容性

1. 在 Windows 桌面平台中，触摸事件支持已修复并重新启用。

2. Bug 888304 中 中出现的 Web 兼容性问题。

相关链接

• 触摸事件概述
• Document.createTouch()