PointerEvent: azimuthAngle-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 azimuthAngle schreibgeschützte Eigenschaft der PointerEvent-Schnittstelle repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (Zeiger oder Stift) als auch die Y-Achse enthält.
Abhängig von der spezifischen Hardware und Plattform werden Benutzeragenten wahrscheinlich nur einen Satz von Werten für die Orientierung des Transducers relativ zur Bildebene erhalten — entweder tiltX und tiltY oder altitudeAngle und azimuthAngle.
Für eine weitere Veranschaulichung dieser Eigenschaft siehe Abbildung 5 in der Spezifikation.
Wert
Ein Winkel in Bogenmaß zwischen 0 und 2π, wobei 0 einen Transducer repräsentiert, dessen Spitze in Richtung zunehmender X-Werte zeigt (zeigt auf "3 Uhr", wenn man direkt von oben schaut) auf der X-Y-Ebene, und die Werte erhöhen sich progressiv im Uhrzeigersinn (π/2 bei "6 Uhr", π bei "9 Uhr", 3π/2 bei "12 Uhr").
Wenn der Transducer senkrecht zur Oberfläche ist (altitudeAngle von π/2), liegt der Wert bei 0.
Für Hardware und Plattformen, die Neigungs- oder Winkelinformationen nicht melden, beträgt der Wert 0.
Beispiel
someElement.addEventListener("pointerdown", (event) => {
process_angles(event.altitudeAngle, event.azimuthAngle);
});
Spezifikationen
| Specification |
|---|
| Pointer Events> # dom-pointerevent-azimuthangle> |