文档: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);

规范

此功能不是任何当前规范的一部分。它已不再有望成为标准。

浏览器兼容性

另见