Touch

Limited availability

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

Die Touch-Schnittstelle repräsentiert einen einzelnen Kontaktpunkt auf einem berührungsempfindlichen Gerät. Der Kontaktpunkt ist üblicherweise ein Finger oder ein Stylus und das Gerät kann ein Touchscreen oder ein Trackpad sein.

Die Eigenschaften Touch.radiusX, Touch.radiusY und Touch.rotationAngle beschreiben den Berührungsbereich zwischen dem Benutzer und dem Bildschirm, das Berührungsgebiet. Dies kann nützlich sein, wenn es um ungenaue Zeigegeräte wie Finger geht. Diese Werte sind so festgelegt, dass sie eine Ellipse beschreiben, die so genau wie möglich dem gesamten Kontaktbereich entspricht (wie z.B. der Fingerspitze des Benutzers).

Hinweis: Viele der Werte von Eigenschaften hängen von der Hardware ab; wenn das Gerät z.B. keine Möglichkeit hat, den Druck auf der Oberfläche zu erkennen, wird der force-Wert immer 0 sein. Dies könnte auch für radiusX und radiusY der Fall sein; wenn die Hardware nur einen einzigen Punkt meldet, sind diese Werte 1.

Konstruktor

Touch()

Erstellt ein Touch-Objekt.

Instanz-Eigenschaften

Diese Schnittstelle hat kein übergeordnetes Element und erbt oder implementiert keine anderen Eigenschaften.

Grundlegende Eigenschaften

Touch.identifier Nur lesbar

Gibt einen eindeutigen Bezeichner für dieses Touch-Objekt zurück. Ein gegebener Berührungspunkt (z.B. durch einen Finger) hat denselben Bezeichner für die gesamte Dauer seiner Bewegung über die Oberfläche. So können Sie sicherstellen, dass Sie immer denselben Berührungspunkt verfolgen.

Touch.screenX Nur lesbar

Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Bildschirms zurück.

Touch.screenY Nur lesbar

Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Bildschirms zurück.

Touch.clientX Nur lesbar

Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Browser-Viewports zurück, ohne jeden Scrollversatz.

Touch.clientY Nur lesbar

Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Browser-Viewports zurück, ohne jeden Scrollversatz.

Touch.pageX Nur lesbar

Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Dokuments zurück. Im Gegensatz zu clientX enthält dieser Wert einen eventuellen horizontalen Scrollversatz.

Touch.pageY Nur lesbar

Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Dokuments zurück. Im Gegensatz zu clientY enthält dieser Wert einen eventuellen vertikalen Scrollversatz.

Touch.target Nur lesbar

Gibt das Element zurück, auf dem der Berührungspunkt beim ersten Aufsetzen auf die Oberfläche gestartet wurde, auch wenn der Berührungspunkt seitdem außerhalb des interaktiven Bereichs dieses Elements bewegt oder sogar aus dem Dokument entfernt wurde.

Berührungsgebiet

Touch.radiusX Nur lesbar

Gibt den X-Radius der Ellipse zurück, die das Berührungsgebiet auf dem Bildschirm am genauesten umschreibt. Der Wert ist in Pixeln derselben Skala wie screenX.

Touch.radiusY Nur lesbar

Gibt den Y-Radius der Ellipse zurück, die das Berührungsgebiet auf dem Bildschirm am genauesten umschreibt. Der Wert ist in Pixeln derselben Skala wie screenY.

Touch.rotationAngle Nur lesbar

Gibt den Winkel (in Grad) zurück, um den die durch radiusX und radiusY beschriebene Ellipse im Uhrzeigersinn gedreht werden muss, um das Berührungsgebiet zwischen Benutzer und Oberfläche am genauesten abzudecken.

Touch.force Nur lesbar

Gibt den Druck an, der von der Benutzeroberfläche auf die Oberfläche ausgeübt wird, als float zwischen 0.0 (kein Druck) und 1.0 (maximaler Druck).

Instanz-Methoden

Diese Schnittstelle hat keine Methoden und kein übergeordnetes Element und erbt oder implementiert keine Methoden.

Spezifikationen

Specification
Touch Events
# touch-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch