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

BCD tables only load in the browser

Siehe auch