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
Schreibgeschützt-
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
Schreibgeschützt-
Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Bildschirms zurück.
Touch.screenY
Schreibgeschützt-
Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Bildschirms zurück.
Touch.clientX
Schreibgeschützt-
Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Browser-Viewports zurück, ohne jeden Scrollversatz.
Touch.clientY
Schreibgeschützt-
Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Browser-Viewports zurück, ohne jeden Scrollversatz.
Touch.pageX
Schreibgeschützt-
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
Schreibgeschützt-
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
Schreibgeschützt-
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
Schreibgeschützt-
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
Schreibgeschützt-
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
Schreibgeschützt-
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
Schreibgeschützt-
Gibt den Druck an, der von der Benutzeroberfläche auf die Oberfläche ausgeübt wird, als
float
zwischen0.0
(kein Druck) und1.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