Touch

可用性有限

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

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

Touch.radiusXTouch.radiusYTouch.rotationAngle 描述了用户与屏幕之间的接触区域,即触摸区域。这在处理手指等不精确的输入设备时可能很有用。这些值用于描述一个最能匹配整个接触区域(例如用户指尖)的椭圆。

注意:许多属性的值都依赖于硬件;例如,如果设备无法检测到施加在表面上的压力大小,force 的值将始终为 0。radiusXradiusY 也可能出现这种情况;如果硬件只报告一个点,这些值将为 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 只读

返回用户施加在表面上的压力大小,为一个介于 0.0(无压力)和 1.0(最大压力)之间的 float 值。

实例方法

此接口没有方法,没有父接口,也不继承或实现任何方法。

规范

规范
触摸事件
# touch-interface

浏览器兼容性

另见