-
Notifications
You must be signed in to change notification settings - Fork 22.5k
/
index.md
52 lines (36 loc) · 1.72 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
---
title: "PointerEvent: tiltY property"
short-title: tiltY
slug: Web/API/PointerEvent/tiltY
page-type: web-api-instance-property
browser-compat: api.PointerEvent.tiltY
---
{{ APIRef("Pointer Events") }}
The **`tiltY`** read-only property of the {{domxref("PointerEvent")}} interface is the angle (in degrees) between the _X-Z plane_ of the pointer and the screen.
This property is typically only useful for a pen/stylus pointer type.
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 — either {{domxref("PointerEvent.tiltx", "tiltX")}} and `tiltY` or {{domxref("PointerEvent.altitudeAngle", "altitudeAngle")}} and {{domxref("PointerEvent.azimuthAngle", "azimuthAngle")}}.
![The tiltX angle of a pointer compared to the tiltY angle](tilt_x_y_angles.svg)
For an additional illustration of this property, see [Figure 3 in the specification](https://w3c.github.io/pointerevents/#dom-pointerevent-tilty).
## Value
The angle in degrees between the X-Z plane of the pointer (stylus) and the screen.
The range of values is `-90` to `90`, inclusive, where a positive value is a tilt towards the user.
For devices that do not support this property, the value is `0`.
## Examples
This example illustrates simple accessing of the {{domxref("PointerEvent.tiltX","tiltX")}} and `tiltY` properties.
```js
someElement.addEventListener(
"pointerdown",
(event) => {
process_tilt(event.tiltX, event.tiltY);
},
false,
);
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- {{domxref("PointerEvent.tiltX")}}
- {{domxref("PointerEvent.altitudeAngle")}}
- {{domxref("PointerEvent.azimuthAngle")}}