ScreenOrientation

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.

* Some parts of this feature may have varying levels of support.

Giao diện ScreenOrientation của Screen Orientation API cung cấp thông tin về hướng hiện tại của tài liệu.

Một đối tượng phiên bản ScreenOrientation có thể được lấy bằng thuộc tính screen.orientation.

EventTarget ScreenOrientation

Thuộc tính phiên bản

ScreenOrientation.type Read only

Trả về loại hướng hiện tại của tài liệu, một trong các giá trị portrait-primary, portrait-secondary, landscape-primary, hoặc landscape-secondary.

ScreenOrientation.angle Read only

Trả về góc hướng hiện tại của tài liệu.

Phương thức phiên bản

ScreenOrientation.lock()

Khóa hướng của tài liệu chứa về hướng mặc định của nó và trả về một Promise.

ScreenOrientation.unlock()

Mở khóa hướng của tài liệu chứa khỏi hướng mặc định của nó.

Sự kiện

Lắng nghe các sự kiện này bằng addEventListener() hoặc bằng cách gán trình lắng nghe sự kiện vào thuộc tính oneventname của giao diện này.

change

Được kích hoạt mỗi khi màn hình thay đổi hướng.

Ví dụ

Trong ví dụ sau, chúng ta lắng nghe sự kiện change của hướng và ghi lại screen orientation typeangle mới.

js
screen.orientation.addEventListener("change", (event) => {
  const type = event.target.type;
  const angle = event.target.angle;
  console.log(`ScreenOrientation change: ${type}, ${angle} degrees.`);
});

Thông số kỹ thuật

Specification
Screen Orientation
# screenorientation-interface

Tương thích trình duyệt