Document: createTouch()-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.createTouch()-Methode erstellt und gibt ein neues Touch-Objekt zurück.

Hinweis: Verwenden Sie den TouchEvent()-Konstruktor.

Syntax

js
createTouch(view, target, identifier, pageX, pageY, screenX, screenY)

Parameter

Hinweis: Alle Parameter sind optional.

view

Das window, in dem der Touch aufgetreten ist.

target

Das EventTarget für den Touch.

identifier

Der Wert für Touch.identifier.

pageX

Der Wert für Touch.pageX.

pageY

Der Wert für Touch.pageY.

screenX

Der Wert für Touch.screenX.

screenY

Der Wert für Touch.screenY.

Hinweis: Frühere Versionen dieser Methode enthielten die folgenden zusätzlichen Parameter, aber diese Parameter sind in keiner der unten aufgeführten Spezifikationen enthalten. Folglich sollten diese Parameter als veraltet betrachtet und nicht verwendet werden.

clientX

Der Wert für Touch.clientX.

clientY

Der Wert für Touch.clientY.

radiusX

Der Wert für Touch.radiusX.

radiusY

Der Wert für Touch.radiusY.

rotationAngle

Der Wert für Touch.rotationAngle.

force

Der Wert für Touch.force.

Rückgabewert

touch

Ein Touch-Objekt, das gemäß den Eingabeparametern konfiguriert ist.

Beispiele

Dieses Beispiel veranschaulicht die Verwendung der Document.createTouch()-Methode zum Erstellen von Touch-Objekten.

Im folgenden Codeausschnitt werden zwei Touch-Objekte für das target-Element erstellt.

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

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

Spezifikationen

Diese Funktion ist nicht Teil einer aktuellen Spezifikation. Sie ist nicht mehr auf dem Weg, ein Standard zu werden.

Browser-Kompatibilität

Siehe auch