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

瀏覽器相容性