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;
  }
});

規範

規範
觸控事件
# dom-touchevent-touches

瀏覽器相容性