PointerEvent: tiltX-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Die schreibgeschützte Eigenschaft tiltX des PointerEvent-Interfaces ist der Winkel (in Grad) zwischen der Y-Z-Ebene des Zeigers und dem Bildschirm. Diese Eigenschaft ist typischerweise nur für einen Stift- oder Stylus-Zeigertyp nützlich.

Je nach spezifischer Hardware und Plattform werden die Benutzeragenten wahrscheinlich nur einen Satz von Werten für die Ausrichtung des Überträgers relativ zur Bildebene erhalten — entweder tiltX und tiltY oder altitudeAngle und azimuthAngle.

Der tiltX-Winkel eines Zeigers im Vergleich zum tiltY-Winkel

Für eine zusätzliche Veranschaulichung dieser Eigenschaft siehe Abbildung 2 in der Spezifikation.

Wert

Der Winkel in Grad zwischen der Y-Z-Ebene des Zeigers (Stylus) und dem Bildschirm. Der Wertebereich reicht von -90 bis 90, einschließlich, wobei ein positiver Wert eine Neigung nach rechts darstellt. Für Geräte, die diese Eigenschaft nicht unterstützen, beträgt der Wert 0.

Beispiele

Dieses Beispiel veranschaulicht den einfachen Zugriff auf die Eigenschaften tiltX und tiltY.

js
someElement.addEventListener(
  "pointerdown",
  (event) => {
    process_tilt(event.tiltX, event.tiltY);
  },
  false,
);

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-tiltx

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch