Screen: phương thức lockOrientation()
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Phương thức lockOrientation() của giao diện Screen khóa màn hình vào một hướng được chỉ định.
Warning:
Tính năng này đã lỗi thời và nên được tránh. Sử dụng phương thức ScreenOrientation.lock() thay thế.
Note: Phương thức này chỉ hoạt động cho các ứng dụng Web đã cài đặt hoặc cho các trang Web ở chế độ toàn màn hình.
Cú pháp
lockOrientation(orientation)
Tham số
orientation-
Hướng cần khóa màn hình vào. Đây có thể là một chuỗi hoặc một mảng các chuỗi. Truyền nhiều chuỗi cho phép màn hình chỉ xoay ở các hướng đã chọn.
Các chuỗi sau đại diện cho các yêu cầu hướng có thể mà bạn có thể chỉ định:
portrait-primary-
Đại diện cho hướng của màn hình khi nó ở chế độ dọc chính. Một màn hình được coi là ở chế độ dọc chính nếu thiết bị được giữ ở vị trí bình thường và vị trí đó ở chế độ dọc, hoặc nếu vị trí bình thường của thiết bị ở chế độ ngang và thiết bị được xoay 90° theo chiều kim đồng hồ. Vị trí bình thường phụ thuộc vào thiết bị.
portrait-secondary-
Đại diện cho hướng của màn hình khi nó ở chế độ dọc phụ. Một màn hình được coi là ở chế độ dọc phụ nếu thiết bị được xoay 180° từ vị trí bình thường và vị trí đó ở chế độ dọc, hoặc nếu vị trí bình thường của thiết bị ở chế độ ngang và thiết bị được xoay 90° ngược chiều kim đồng hồ. Vị trí bình thường phụ thuộc vào thiết bị.
landscape-primary-
Đại diện cho hướng của màn hình khi nó ở chế độ ngang chính. Một màn hình được coi là ở chế độ ngang chính nếu thiết bị được giữ ở vị trí bình thường và vị trí đó ở chế độ ngang, hoặc nếu vị trí bình thường của thiết bị ở chế độ dọc và thiết bị được xoay 90° theo chiều kim đồng hồ. Vị trí bình thường phụ thuộc vào thiết bị.
landscape-secondary-
Đại diện cho hướng của màn hình khi nó ở chế độ ngang phụ. Một màn hình được coi là ở chế độ ngang phụ nếu thiết bị được xoay 180° từ vị trí bình thường và vị trí đó ở chế độ ngang, hoặc nếu vị trí bình thường của thiết bị ở chế độ dọc và thiết bị được xoay 90° ngược chiều kim đồng hồ. Vị trí bình thường phụ thuộc vào thiết bị.
portrait-
Đại diện cho cả
portrait-primaryvàportrait-secondary. landscape-
Đại diện cho cả
landscape-primaryvàlandscape-secondary. default-
Đại diện cho
portrait-primaryhoặclandscape-primarytùy thuộc vào hướng tự nhiên của thiết bị. Ví dụ, nếu độ phân giải màn hình là 1280*800,defaultsẽ đặt thành ngang, nếu độ phân giải là 800*1280,defaultsẽ đặt thành dọc.
Note: Có thể đặt nhiều khóa cùng lúc. Vì vậy, nếu khóa được đặt cho chỉ một hướng, hướng màn hình sẽ không bao giờ thay đổi cho đến khi hướng màn hình được mở khóa. Ngược lại, hướng màn hình sẽ thay đổi từ hướng này sang hướng khác miễn là các hướng nằm trong số các hướng mà thiết bị đã được khóa.
Giá trị trả về
Trả về true nếu hướng được ủy quyền để khóa hoặc false nếu việc khóa hướng bị từ chối. Lưu ý rằng giá trị trả về không cho biết rằng hướng màn hình thực sự đã bị khóa: có thể có độ trễ.
Ví dụ
Sử dụng với tham số chuỗi
screen.lockOrientationUniversal =
screen.lockOrientation ||
screen.mozLockOrientation ||
screen.msLockOrientation;
if (screen.lockOrientationUniversal("landscape-primary")) {
// Hướng đã được khóa
} else {
// Khóa hướng thất bại
}
Sử dụng với tham số Array
screen.lockOrientationUniversal =
screen.lockOrientation ||
screen.mozLockOrientation ||
screen.msLockOrientation;
if (
screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])
) {
// Hướng đã được khóa
} else {
// Khóa hướng thất bại
}
Đặc tả kỹ thuật
Tính năng này không phải là một phần của bất kỳ đặc tả kỹ thuật nào. Nó không còn nằm trong lộ trình trở thành tiêu chuẩn.
Sử dụng ScreenOrientation.lock() thay thế.