此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Touch()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

Touch() 构造器创建一个新的 Touch 对象。

语法

js
new Touch(options)

参数

touchInit

是一个TouchInit 字典,它拥有以下属性:

  • "identifier", 必须,是一个长整型,表示一个触摸点的数字标记。
  • "target", 必须,是 EventTarget类型,表示在触摸点开始接触接触面时的节点。
  • "clientX", 可选,默认为 0,为双精度浮点数类型,表示触摸在浏览器视口的横轴坐标,不包括滚动条的偏移距离。
  • "clientY", 可选,默认为 0,为双精度浮点数类型,表示触摸在浏览器视口的横轴坐标,不包括滚动条的偏移距离。
  • "screenX", 可选,默认为 0,为双精度浮点数类型,表示以用户屏幕为基准的,触摸点横坐标。
  • "screenY", 可选,默认为 0,为双精度浮点数类型,表示以用户屏幕为基准的,触摸点纵坐标。
  • "pageX",可选,默认为 0,为双精度浮点数类型,表示触摸在用户屏幕的横轴坐标,包括滚动条的偏移距离。
  • "pageY", 可选,默认为 0,为双精度浮点数类型,表示触摸在用户屏幕的纵轴坐标,包括滚动条的偏移距离。
  • "radiusX", 可选,默认为 0,为浮点数类型。表示接触面(比如手指,触控笔)接触形成的椭圆,在 rotationAngle 角度下横轴上形成的椭圆半径。和 screenX 使用的 CSS 像素保持同一个缩放大小。这个值不能为负。
  • "radiusY", 可选,默认为 0,为浮点数类型。表示接触面(比如手指,触控笔)接触形成的椭圆,在 rotationAngle 角度下纵轴上形成的椭圆半径。和 screenY 使用的 CSS 像素保持同一个缩放大小。这个值不能为负。
  • "rotationAngle", 可选,默认为 0,为浮点数类型。表示由 radiusX 和 radiusY 决定的椭圆在顺时针方向相对其中心偏转的角度。这个值介于 0 到 90 度之间。如果由 radiusX 和 radiusY 决定的椭圆是一个标准圆形,则 rotationAngle 没有任何效用。用户设备可能用 0 表示这种标准圆形的情况,或者用其他符合要求范围的值来表示(比如,用户设备可能用上一次的触摸事件 rotationAngle 值,来避免突然变动)。
  • "force",可选,默认为 0,为浮点数类型。表示触摸体对触摸面的压力值。范围为从 0 到 1:0 表示压力为零,1 表示设备能承受的最大压力敏感值。对压力的敏感值变动范围根据不同环境变动比较大。

规范

Specification
Touch Events
# dom-touch-constructor

浏览器兼容性

参见