PointerEvent: altitudeAngle property
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.
Thuộc tính chỉ đọc altitudeAngle của giao diện PointerEvent đại diện cho góc giữa trục của một bộ chuyển đổi (một con trỏ hoặc bút stylus) và mặt phẳng X-Y của màn hình thiết bị.
Góc độ cao mô tả liệu bộ chuyển đổi có vuông góc với màn hình, song song với màn hình, hay ở góc độ nào đó ở giữa.
Tùy thuộc vào phần cứng và nền tảng cụ thể, tác nhân người dùng thường chỉ nhận được một tập giá trị cho hướng của bộ chuyển đổi so với mặt phẳng màn hình - hoặc là tiltX và tiltY, hoặc là altitudeAngle và azimuthAngle.
Để xem thêm minh họa về thuộc tính này, hãy xem Hình 4 trong đặc tả.
Giá trị
Một góc tính bằng radian trong khoảng 0 đến π/2, trong đó 0 là song song với bề mặt thiết bị (mặt phẳng X-Y), và π/2 là vuông góc với bề mặt.
Mặc định là π/2 (vuông góc với bề mặt), khác với altitudeAngle trong touch events mặc định là 0 (song song với bề mặt).
Đối với phần cứng và nền tảng không báo cáo góc nghiêng hoặc góc độ, giá trị là π/2.
Ví dụ
someElement.addEventListener("pointerdown", (event) => {
process_angles(event.altitudeAngle, event.azimuthAngle);
});
Thông số kỹ thuật
| Specification |
|---|
| Pointer Events # dom-pointerevent-altitudeangle |