DieTouch-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 EigenschaftenTouch.radiusX,Touch.radiusY undTouch.rotationAngle beschreiben den Bereich des Kontakts zwischen dem Benutzer und dem Bildschirm, dieBerührungsfläche. Dies kann hilfreich sein, wenn man mit ungenauen Zeigegeräten wie Fingern arbeitet. Diese Werte sind so festgelegt, dass sie eine Ellipse beschreiben, die den gesamten Kontaktbereich (wie die Fingerspitze des Benutzers) so genau wie möglich umfasst.

Konstruktor

Touch()

Erstellt ein Touch-Objekt.

Instanz-Eigenschaften

Diese Schnittstelle hat keinen übergeordneten Typ und erbt oder implementiert keine anderen Eigenschaften.

Grundlegende Eigenschaften

Touch.identifierSchreibgeschützt

Gibt einen eindeutigen Bezeichner für diesesTouch-Objekt zurück. Ein bestimmter Berührungspunkt (beispielsweise ein Finger) hat während seiner Bewegung auf der Oberfläche denselben Bezeichner. Dies ermöglicht es Ihnen sicherzustellen, dass Sie immer dieselbe Berührung nachverfolgen.

Touch.screenXSchreibgeschützt

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

Touch.screenYSchreibgeschützt

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

Touch.clientXSchreibgeschützt

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

Touch.clientYSchreibgeschützt

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

Touch.pageXSchreibgeschützt

Gibt die X-Koordinate des Berührungspunkts relativ zum linken Rand des Dokuments zurück. Im Gegensatz zuclientX enthält dieser Wert den horizontalen Scroll-Offset, falls vorhanden.

Touch.pageYSchreibgeschützt

Gibt die Y-Koordinate des Berührungspunkts relativ zum oberen Rand des Dokuments zurück. Im Gegensatz zuclientY enthält dieser Wert den vertikalen Scroll-Offset, falls vorhanden.

Touch.targetSchreibgeschützt

Gibt dasElement zurück, bei dem der Berührungspunkt ursprünglich auf die Oberfläche gesetzt wurde, auch wenn der Berührungspunkt seitdem das interaktive Gebiet dieses Elements verlassen oder gar aus dem Dokument entfernt wurde.

Berührungsfläche

Touch.radiusXSchreibgeschützt

Gibt den X-Radius der Ellipse zurück, die am engsten den Kontaktbereich mit dem Bildschirm umschreibt. Der Wert ist in Pixeln derselben Skala wiescreenX.

Touch.radiusYSchreibgeschützt

Gibt den Y-Radius der Ellipse zurück, die am engsten den Kontaktbereich mit dem Bildschirm umschreibt. Der Wert ist in Pixeln derselben Skala wiescreenY.

Touch.rotationAngleSchreibgeschützt

Gibt den Winkel (in Grad) an, um den die durchradiusX undradiusY beschriebene Ellipse im Uhrzeigersinn gedreht werden muss, um den Kontaktbereich zwischen Benutzer und Oberfläche am genauesten abzudecken.

Touch.forceSchreibgeschützt

Gibt den Druck zurück, der von der Benutzeroberfläche des Nutzers ausgeübt wird, alsfloat zwischen0.0 (kein Druck) und1.0 (maximaler Druck).

Berührungstyp und Winkel

Touch.altitudeAngleSchreibgeschützt

Gibt den Winkel (in Radiant) zwischen der Achse des Abtasters (Zeiger oder Stylus) und der X-Y-Ebene des Geräts im Bereich von0 (parallel zur Oberfläche) bisπ/2 (senkrecht zur Oberfläche) zurück. Voreinstellung ist0 für Hardware, die keine Neigung oder Winkel meldet.

Touch.azimuthAngleSchreibgeschützt

Gibt den Azimutwinkel (in Radiant) des Abtasters (Zeiger oder Stylus) im Bereich von0 bis2π zurück.0 steht für einen Abtaster, dessen Spitze in Richtung zunehmender X-Werte auf der X-Y-Ebene zeigt, wobei die Werte im Uhrzeigersinn zunehmen.

Touch.touchTypeSchreibgeschützt

Gibt den Gerätetyp zurück, der die Berührung ausgelöst hat, wie"direct" für einen Finger oder"stylus" für ein Stiftgerät.

Instanz-Methoden

Diese Schnittstelle hat keine Methoden und keinen übergeordneten Typ und erbt oder implementiert keine Methoden.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Berührungsereignisse
• Document.createTouch()