触摸
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
只读-
返回用户施加在表面上的压力量,作为
0.0
(无压力)和1.0
(最大压力)之间的float
值。
实例方法
此接口没有方法和父级,也不继承或实现任何方法。
规范
规范 |
---|
触摸事件 # touch-interface |
浏览器兼容性
BCD 表仅在启用了 JavaScript 的浏览器中加载。