Document: createTouchList()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die Document.createTouchList()-Methode erstellt und gibt ein neues TouchList-Objekt zurück.

Syntax

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

Parameter

touch1, …, touchN

Null oder mehr Touch-Objekte. Hinweis: Firefox akzeptiert auch ein Array von Touch-Objekten.

Rückgabewert

list

Ein TouchList-Objekt, das die durch den touches-Parameter spezifizierten Touch-Objekte enthält.

Beispiele

Dieses Beispiel veranschaulicht die Verwendung der Document.createTouchList()-Methode zur Erstellung von TouchList-Objekten.

Im folgenden Code-Snippet werden einige Touch-Objekte für das target-Element erstellt, und diese Berührungspunkte werden dann verwendet, um einige TouchList-Objekte zu erstellen.

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

Spezifikationen

Diese Funktion ist derzeit nicht Teil einer Spezifikation. Sie ist nicht länger auf dem Weg, ein Standard zu werden.

Browser-Kompatibilität

Siehe auch