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 schreibgeschützte Eigenschaft altitudeAngle des PointerEvent-Interfaces repräsentiert den Winkel zwischen der Achse eines Transducers (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräteschirms. Der Höhenwinkel beschreibt, ob der Transducer senkrecht zum Bildschirm, parallel oder in einem Zwischenwinkel ist.
Abhängig von der spezifischen Hardware und Plattform erhalten Benutzeragenten wahrscheinlich nur einen Satz von Werten für die Orientierung des Transducers relativ zur Bildschirmebene - entweder tiltX und tiltY oder altitudeAngle und azimuthAngle.
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 steht. Der Standardwert ist π/2 (senkrecht zur Oberfläche), was sich vom altitudeAngle in Touch-Ereignissen unterscheidet, der standardmäßig 0 (parallel zur Oberfläche) ist. Für Hardware und Plattformen, die keine Neigung oder Winkel melden, ist der Wert π/2.
Beispiel
someElement.addEventListener("pointerdown", (event) => {
process_angles(event.altitudeAngle, event.azimuthAngle);
});
Spezifikationen
| Specification |
|---|
| Pointer Events # dom-pointerevent-altitudeangle |