此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

TouchList

Limited availability

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

TouchList 介面表示觸控表面上的接觸點清單。例如,當使用者以三根手指接觸觸控表面(如螢幕或觸控板)時,對應的 TouchList 物件中會包含三個 Touch 物件,各代表一根手指。

這個介面最初是為了建立一個不可修改的清單而設計,現在仍被支援僅是為了避免破壞既有程式碼。現代 API 使用以 JavaScript 陣列為基礎的型別來表示清單結構,這讓許多陣列方法能夠使用,同時也為使用這些結構帶來更多語意(例如將項目設為唯讀)。

然而,這些歷史原因並不表示你身為開發者應該避免使用 TouchList。你無需自行建立 TouchList 物件,而是透過像是 TouchEvent.targetTouches 這類 API 取得,且這些 API 並未被淘汰。但你仍需留意它與真正陣列之間的語意差異。

實例屬性

TouchList.length Read only

TouchList 中的 Touch 物件數量。

實例方法

TouchList.item()

回傳清單中指定索引位置的 Touch 物件。

範例

請參見主篇文章中的觸控事件範例

規範

Specification
Touch Events
# touchlist-interface

瀏覽器相容性

參見