PointerEvent: azimuthAngle property
Baseline 2024Newly available
Since December 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
TheazimuthAngle read-only property of thePointerEvent interface represents the angle between the Y-Z plane and the plane containing both the transducer (pointer or stylus) axis and the Y axis.
Depending on the specific hardware and platform, user agents will likely only receive one set of values for the transducer orientation relative to the screen plane — eithertiltX andtiltY oraltitudeAngle andazimuthAngle.
For an additional illustration of this property, seeFigure 5 in the specification.
In this article
Value
An angle in radians between0 and2π where0 represents a transducer whose cap is pointing in the direction of increasing X values (point to "3 o'clock" if looking straight down) on the X-Y plane, and the values progressively increase when going clockwise (π/2 at "6 o'clock",π at "9 o'clock",3π/2 at "12 o'clock").
When the transducer is perpendicular to the surface (altitudeAngle ofπ/2), the value is 0.For hardware and platforms that do not report tilt or angle, the value is0.
Example
someElement.addEventListener("pointerdown", (event) => { process_angles(event.altitudeAngle, event.azimuthAngle);});Specifications
| Specification |
|---|
| Pointer Events> # dom-pointerevent-azimuthangle> |