Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

PointerEvent: altitudeAngle-Eigenschaft

Baseline 2024
Newly available

Since ⁨December 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die altitudeAngle schreibgeschützte Eigenschaft des PointerEvent-Interfaces repräsentiert den Winkel zwischen der Achse eines Transducers (einem Eingabegerät oder Stylus) und der X-Y-Ebene eines Gerätes Bildschirms. Der Höhenwinkel beschreibt, ob der Transducer senkrecht zum Bildschirm, parallel oder in einem Winkel dazwischen steht.

Je nach spezifischer Hardware und Plattform werden Benutzeragenten wahrscheinlich nur einen Satz von Werten für die Orientierung des Transducers relativ zur Bildschirmebene erhalten — entweder tiltX und tiltY oder altitudeAngle und azimuthAngle.

Der Azimutwinkel eines Pointers im Vergleich zum Höhenwinkel

Für eine zusätzliche Illustration dieser Eigenschaft, siehe Abbildung 4 in der Spezifikation.

Wert

Ein Winkel in Radiant zwischen 0 und π/2, wobei 0 parallel zur Geräteoberfläche (X-Y-Ebene) ist und π/2 senkrecht zur Oberfläche. Standardmäßig ist der Wert π/2 (senkrecht zur Oberfläche), was sich von der altitudeAngle in Touch Events unterscheidet, welche standardmäßig 0 (parallel zur Oberfläche) ist. Für Hardware und Plattformen, die keine Neigung oder Winkel melden, ist der Wert π/2.

Beispiel

js
someElement.addEventListener("pointerdown", (event) => {
  process_angles(event.altitudeAngle, event.azimuthAngle);
});

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-altitudeangle

Browser-Kompatibilität

Siehe auch