PointerEvent: altitudeAngle-Eigenschaft

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 Winkel dazwischen ist.

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

Der Azimutwinkel eines Zeigers im Vergleich zum Höhenwinkel

Für eine zusätzliche Darstellung 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) und π/2 senkrecht zur Oberfläche ist. Der Standardwert ist π/2 (senkrecht zur Oberfläche), was sich von der altitudeAngle in Touch-Ereignissen unterscheidet, die standardmäßig 0 (parallel zur Oberfläche) ist. Für Hardware und Plattformen, die keine Neigung oder Winkel melden, beträgt der Wert π/2.

Beispiel

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

Spezifikationen

Specification
Pointer Events
# dom-pointerevent-altitudeangle

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
altitudeAngle

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch