Заголовки: Permissions-Policy.fullscreen
Директива fullscreen заголовка Permissions-Policy
Ограниченная доступность
Эта функция не входит в Baseline, поскольку она не работает в некоторых наиболее широко используемых браузерах.
Хотите, чтобы эта функция поддерживалась лучше? Расскажите нам почему.
Экспериментальная функция: Это экспериментальная технология
Перед использованием в рабочей среде внимательно ознакомьтесь с таблицей совместимости с браузерами.
Директива fullscreen заголовка HTTP Permissions-Policy управляет тем, разрешено ли текущему документу использовать Element.requestFullscreen().
В частности, если определённая политика запрещает использование этой функции, вызовы requestFullscreen() возвращают Promise, который отклоняется с ошибкой TypeError.
Примечание: Если эта директива (то есть через атрибут allow) и атрибут allowfullscreen присутствуют у элемента <iframe>, приоритет имеет эта директива.
Синтаксис
Permissions-Policy: fullscreen=<allowlist>;
<allowlist>-
Список источников, которым разрешено использовать эту функцию. Подробнее см. в разделе
Permissions-Policy> Синтаксис.
Политика по умолчанию
Список разрешённых источников по умолчанию для fullscreen — self. Контекст просмотра верхнего уровня и iframe с тем же источником по умолчанию имеют доступ к функции fullscreen.
Примеры
>Основное использование
Компания SecureCorp Inc. хочет запретить fullscreen во всех iframe с другим источником, кроме тех, источник которых — https://example.com. Для этого она может отправить следующий заголовок HTTP-ответа, чтобы определить политику разрешений:
Permissions-Policy: fullscreen=(self "https://example.com")
Компания SecureCorp Inc. также должна добавить атрибут allow к каждому элементу <iframe>, в котором необходимо разрешить fullscreen:
<iframe src="https://example.com/presentation" allow="fullscreen"></iframe>
Примечание: Указание заголовка Permissions-Policy таким образом запрещает fullscreen для других источников, даже если они разрешены атрибутом <iframe> allow.
Использование политики по умолчанию
Если список разрешённых источников для fullscreen не задан заголовком ответа Permissions-Policy, пользовательские агенты применяют список разрешённых источников по умолчанию self. В этом режиме fullscreen автоматически разрешён в контексте просмотра верхнего уровня и iframe с тем же источником, но не в iframe с другим источником.
Чтобы разрешить fullscreen в iframe с другим источником, добавьте атрибут allow к элементу <iframe>:
<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>
Спецификации
| Спецификация |
|---|
| Fullscreen API> # permissions-policy-integration> |
Совместимость с браузерами
| Компьютер | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | WebView на iOS | |
fullscreen |
88 | 88 | Нет | 74 | Нет | 88 | Нет | 63 | Нет | 15.0 | 88 | Нет |
См. также
-
Заголовок
Permissions-Policy - Политика разрешений
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/fullscreen
