文件:createTouchList() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

Document.createTouchList() 方法建立並返回一個新的 TouchList 物件。

語法

js
createTouchList(touch1)
createTouchList(touch1, touch2)
createTouchList(touch1, touch2, /* …, */ touchN)

引數

touch1, …, touchN

零個或多個 Touch 物件。Firefox 也接受一個 陣列Touch 物件。

返回值

list

一個 TouchList 物件,包含由 touches 引數指定的 Touch 物件。

示例

本示例演示瞭如何使用 Document.createTouchList() 方法建立 TouchList 物件。

在下面的程式碼片段中,為 target 元素建立了一些 Touch 物件,然後使用這些觸控點來建立一些 TouchList 物件。

js
const target = document.getElementById("target");

// Create some touch points
const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

// Create an empty TouchList objects
const list0 = document.createTouchList();

// Create a TouchList with only one Touch object
const list1 = document.createTouchList(touch1);

// Create a list with two Touch objects
const list2 = document.createTouchList(touch1, touch2);

規範

此功能不是任何當前規範的一部分。它已不再有望成為標準。

瀏覽器相容性

另見