Permissions-Policy: chỉ thị fullscreen
Khả dụng hạn chế
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.
Chỉ thị fullscreen của header HTTP Permissions-Policy kiểm soát việc tài liệu hiện tại có được phép sử dụng Element.requestFullscreen() hay không.
Cụ thể, khi một chính sách đã được xác định chặn việc sử dụng tính năng này, các lần gọi requestFullscreen() sẽ trả về một Promise bị từ chối với một TypeError.
Note:
Nếu cả chỉ thị này (tức là thông qua thuộc tính allow) và thuộc tính allowfullscreen đều có trên một phần tử <iframe>, chỉ thị này sẽ có độ ưu tiên cao hơn.
Cú pháp
Permissions-Policy: fullscreen=<allowlist>;
<allowlist>-
Danh sách các nguồn gốc được cấp quyền sử dụng tính năng. Xem
Permissions-Policy> Cú pháp để biết thêm chi tiết.
Chính sách mặc định
Danh sách cho phép mặc định cho fullscreen là self. Ngữ cảnh duyệt web cấp cao nhất và các iframe cùng nguồn gốc được phép truy cập tính năng fullscreen theo mặc định.
Ví dụ
Sử dụng cơ bản
SecureCorp Inc. muốn vô hiệu hóa fullscreen trong tất cả các iframe cross-origin ngoại trừ những iframe có nguồn gốc là https://example.com. Họ có thể làm điều đó bằng cách gửi header phản hồi HTTP sau để định nghĩa Permissions Policy:
Permissions-Policy: fullscreen=(self "https://example.com")
SecureCorp Inc. cũng phải bao gồm thuộc tính allow trên mỗi phần tử <iframe> mà fullscreen được phép:
<iframe src="https://example.com/presentation" allow="fullscreen"></iframe>
Note:
Chỉ định header Permissions-Policy theo cách này sẽ vô hiệu hóa fullscreen cho các nguồn gốc khác, ngay cả khi chúng được cho phép bởi thuộc tính allow của <iframe>.
Sử dụng chính sách mặc định
Nếu danh sách cho phép cho fullscreen không được xác định bởi header phản hồi Permissions-Policy, các tác nhân người dùng sẽ áp dụng danh sách cho phép mặc định self. Trong chế độ này, fullscreen được tự động cho phép trong ngữ cảnh duyệt web cấp cao nhất và các iframe cùng nguồn gốc, nhưng không được phép trong các iframe cross-origin.
Để cho phép fullscreen trong một iframe cross-origin, hãy bao gồm thuộc tính allow trên phần tử <iframe>:
<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Fullscreen API # permissions-policy-integration |