PointerEvent: azimuthAngle-Eigenschaft
Baseline
2024
Neu verfügbar
Seit December 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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
| Spezifikation |
|---|
| Pointer Events # dom-pointerevent-azimuthangle |