触摸

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

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。

另请参阅