ScreenDetailed
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Giao diện ScreenDetailed của Window Management API đại diện cho thông tin chi tiết về một màn hình cụ thể có sẵn trên thiết bị của người dùng.
Các đối tượng ScreenDetailed có thể được truy cập thông qua thuộc tính ScreenDetails.screens và ScreenDetails.currentScreen.
Thuộc tính phiên bản
Kế thừa các thuộc tính từ lớp cha, Screen.
availLeftRead only Experimental-
Một số đại diện cho tọa độ x (cạnh trái) của vùng màn hình khả dụng.
availTopRead only Experimental-
Một số đại diện cho tọa độ y (cạnh trên) của vùng màn hình khả dụng.
devicePixelRatioRead only Experimental-
Một số đại diện cho tỷ lệ pixel thiết bị của màn hình.
isInternalRead only Experimental-
Một giá trị boolean cho biết màn hình là nội bộ của thiết bị hay bên ngoài.
isPrimaryRead only Experimental-
Một giá trị boolean cho biết màn hình có được đặt làm màn hình chính của hệ điều hành (OS) hay không.
labelRead only Experimental-
Một chuỗi cung cấp nhãn mô tả cho màn hình, ví dụ "Built-in Retina Display".
leftRead only Experimental-
Một số đại diện cho tọa độ x (cạnh trái) của toàn bộ vùng màn hình.
topRead only Experimental-
Một số đại diện cho tọa độ y (cạnh trên) của toàn bộ vùng màn hình.
Sự kiện
Kế thừa các sự kiện từ lớp cha, Screen.
changeExperimental-
Được kích hoạt trên một màn hình cụ thể khi bất kỳ thuộc tính nào của màn hình thay đổi, bao gồm chiều rộng hoặc chiều cao, chiều rộng khả dụng hoặc chiều cao khả dụng, độ sâu màu, hướng, vị trí màn hình, tỷ lệ pixel thiết bị, nhãn hoặc chỉ định màn hình.
Ví dụ
Khi Window.getScreenDetails() được gọi, người dùng sẽ được yêu cầu cấp quyền quản lý cửa sổ trên tất cả các màn hình (trạng thái quyền này có thể kiểm tra bằng Permissions.query() với window-management). Nếu được cấp quyền, đối tượng ScreenDetails kết quả chứa các đối tượng ScreenDetailed đại diện cho tất cả các màn hình có sẵn trên hệ thống của người dùng.
Ví dụ sau mở một cửa sổ ở góc trên bên trái của màn hình chính của OS:
// Return ScreenDetails
const allScreens = await window.getScreenDetails();
// Return the primary screen ScreenDetailed object
const primaryScreenDetailed = allScreens.screens.find(
(screenDetailed) => screenDetailed.isPrimary,
);
// Open a window in the top-left corner of the OS primary screen
window.open(
"https://example.com",
"_blank",
`left=${primaryScreenDetailed.availLeft},
top=${primaryScreenDetailed.availTop},
width=200,
height=200`,
);
Note: Xem Multi-window learning environment để có ví dụ đầy đủ (xem thêm mã nguồn).
Thông số kỹ thuật
| Specification |
|---|
| Window Management # api-screendetailed-interface |