Touch: Touch()-Konstruktor

Limited availability

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

Der Touch()-Konstruktor erstellt ein neues Touch-Objekt.

Syntax

js
new Touch(options)

Parameter

touchInit

Ein Objekt mit den folgenden Feldern:

identifier

Ein long-Wert, der die Identifikationsnummer für den Berührungspunkt ist.

target

Ein EventTarget-Objekt, das Element, auf dem der Berührungspunkt erstmals platziert wurde.

clientX Optional

Standardmäßig 0, vom Typ double, das ist die horizontale Position der Berührung im Client-Fenster des Bildschirms des Benutzers, ohne Scroll-Offset.

clientY Optional

Standardmäßig 0, vom Typ double, das ist die vertikale Position der Berührung im Client-Fenster des Bildschirms des Benutzers, ohne Scroll-Offset.

screenX Optional

Standardmäßig 0, vom Typ double, das ist die horizontale Position der Berührung auf dem Bildschirm des Benutzers.

screenY Optional

Standardmäßig 0, vom Typ double, das ist die vertikale Position der Berührung auf dem Bildschirm des Benutzers.

pageX Optional

Standardmäßig 0, vom Typ double, das ist die horizontale Position der Berührung im Client-Fenster des Bildschirms des Benutzers, einschließlich jeglichen Scroll-Offsets.

pageY Optional

Standardmäßig 0, vom Typ double, das ist die vertikale Position der Berührung im Client-Fenster des Bildschirms des Benutzers, einschließlich jeglichen Scroll-Offsets.

radiusX Optional

Standardmäßig 0, vom Typ float, das ist der Radius der Ellipse, die das Berührungsgebiet (z. B. Finger, Stift) entlang der durch rotationAngle angegebenen Achse am besten umschreibt, in CSS-Pixel derselben Skalierung wie screenX; 0, wenn kein Wert bekannt ist. Der Wert darf nicht negativ sein.

radiusY Optional

Standardmäßig 0, vom Typ float, das ist der Radius der Ellipse, die das Berührungsgebiet (z. B. Finger, Stift) entlang der Achse, die senkrecht zu der durch rotationAngle angegebenen Achse verläuft, am besten umschreibt, in CSS-Pixel derselben Skalierung wie screenY; 0, wenn kein Wert bekannt ist. Der Wert darf nicht negativ sein.

rotationAngle Optional

Standardmäßig 0, vom Typ float, das ist der Winkel (in Grad), um den die durch radiusX und radiusY beschriebene Ellipse im Uhrzeigersinn um ihr Zentrum rotiert wird; 0, wenn kein Wert bekannt ist. Der Wert muss größer oder gleich 0 und kleiner als 90 sein. Wenn die durch radiusX und radiusY beschriebene Ellipse kreisförmig ist, hat rotationAngle keine Auswirkung. Der Benutzeragent kann in diesem Fall 0 als Wert verwenden oder einen anderen Wert im zulässigen Bereich verwenden. (Zum Beispiel kann der Benutzeragent den rotationAngle-Wert aus dem vorherigen Berührungsereignis verwenden, um plötzliche Änderungen zu vermeiden.)

force Optional

Standardmäßig 0, vom Typ float, das ist der relative Wert des ausgeübten Drucks im Bereich von 0 bis 1, wobei 0 kein Druck und 1 der höchste Drucklevel ist, den das Berührungsgerät erkennen kann; 0, wenn kein Wert bekannt ist. In Umgebungen, in denen force bekannt ist, kann der absolute Druck, der durch das force-Attribut dargestellt wird, und die Empfindlichkeit in Druckstufen variieren.

Spezifikationen

Specification
Touch Events
# dom-touch-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • TouchEvent, das Interface der Objekte, die es konstruiert.