TouchEvent:changedTouches 属性

可用性有限

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

changedTouches 只读属性是一个 TouchList,它的触摸点(Touch 对象)会根据事件类型而变化,具体如下所示:

  • 对于 touchstart 事件,它是随当前事件变为活动的触摸点列表。
  • 对于 touchmove 事件,它是自上次事件以来发生变化的触摸点列表。
  • 对于 touchendtouchcancel 事件,它是已从表面移除的触摸点列表(即,对应于不再接触表面的手指的触摸点集合)。

一个 TouchList,其 Touch 对象包括所有促成此触摸事件的触摸点。

示例

此示例说明了 TouchEvent 对象的 TouchEvent.changedTouches 属性。TouchEvent.changedTouches 属性是一个 TouchList 对象,其中包含一个 Touch 对象,对应于每个促成该事件的触摸点。

在下面的代码片段中,touchmove 事件处理程序会遍历 changedTouches 列表,并打印自上次事件以来发生变化的每个触摸点的标识符。

js
someElement.addEventListener("touchmove", (e) => {
  // Iterate through the list of touch points that changed
  // since the last event and print each touch point's identifier.
  for (let i = 0; i < e.changedTouches.length; i++) {
    console.log(
      `changedTouches[${i}].identifier = ${e.changedTouches[i].identifier}`,
    );
  }
});

规范

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

浏览器兼容性