PointerEvent: tiltY-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 tiltY-Eigenschaft der PointerEvent-Schnittstelle ist der Winkel (in Grad) zwischen der X-Z-Ebene des Zeigers und dem Bildschirm. Diese Eigenschaft ist typischerweise nur für einen Stift-/Stylus-Zeigertyp von Nutzen.

Je nach spezifischer Hardware und Plattform erhalten Benutzeragenten wahrscheinlich nur einen Satz von Werten für die Ausrichtung des Wandlerkopfes relativ zur Bildschirmebene — 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 3 in der Spezifikation.

Wert

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

Beispiele

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

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

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-tilty

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch