TouchEvent: touches 属性

touches 是一个只读的 TouchList,列出了当前与触摸表面接触的所有 Touch 对象,无论它们是否发生变化或其目标元素在 touchstart 时是什么。

您可以将其视为能够识别为触摸屏幕的独立手指的数量。

注意:数组中的触摸不一定按发生的顺序排序(数组中的第 i 个元素是发生的第 i 个触摸)。您不能假设特定的顺序。要确定触摸发生的顺序,请使用 touch 对象 ID。

一个 TouchList,列出了当前仍与触摸表面接触的所有 Touch 对象,无论它们是否发生变化或其目标元素在 touchstart 时是什么。

示例

此示例说明了 TouchEvent 对象的 TouchEvent.touches 属性。TouchEvent.touches 属性是一个 TouchList 对象,包含当前触摸表面的每个接触点的 Touch 对象列表。

在下面的代码片段中,touchstart 事件处理程序检查 TouchEvent.touches 列表的长度以确定激活的触摸点的数量,然后根据触摸点的数量调用不同的处理程序。

js
someElement.addEventListener(
  "touchstart",
  (e) => {
    // Invoke the appropriate handler depending on the
    // number of touch points.
    switch (e.touches.length) {
      case 1:
        handle_one_touch(e);
        break;
      case 2:
        handle_two_touches(e);
        break;
      case 3:
        handle_three_touches(e);
        break;
      default:
        console.log("Not supported");
        break;
    }
  },
  false,
);

规范

规范
触摸事件
# dom-touchevent-touches

浏览器兼容性

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