Политика функций: полноэкранный режим

Заголовок HTTP Feature-Policy директива fullscreen управляет тем, разрешено ли текущему документу использовать Element.requestFullscreen(). При включении этой политики возвращаемое Promise отклоняется с TypeError.

По умолчанию, верхнеуровневые документы и их фреймы с одним источником могут запрашивать и переходить в полноэкранный режим. Эта директива разрешает или запрещает фреймам с разными источниками использовать полноэкранный режим. Это включает фреймы с одним источником.

Примечание: Если эта директива (т.е. через атрибут allow ) и атрибут allowfullscreen присутствуют на элементе <iframe>, эта директива имеет приоритет. Была ошибка, из-за которой директива fullscreen не работала, если атрибут allowfullscreen также не был присутствующим, но это было исправлено в Firefox 80 (ошибка 1608358).

Синтаксис

Feature-Policy: fullscreen <allowlist>;

<allowlist>: Список источников, для которых разрешена функция. См. Feature-Policy.

Политика по умолчанию

Список разрешенных источников по умолчанию для fullscreen составляет 'self'.

Примеры

Общий пример

SecureCorp Inc. хочет отключить API полноэкранного режима во всех контекстах просмотра, кроме собственного источника и тех, чьим источником является https://example.com. Для этого можно передать следующий заголовок HTTP ответа для определения политики функций:

Feature-Policy: fullscreen 'self' https://example.com

С элементом <iframe>

FastCorp Inc. хочет отключить fullscreen для всех фреймов-потомков с другим источником, за исключением определённого <iframe>. Для этого можно передать следующий заголовок HTTP ответа для определения политики функций:

Feature-Policy: fullscreen 'self'

Затем включите атрибут разрешения на элементе <iframe>:

<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>

Атрибуты iframe могут выборочно включать функции в определённых фреймах, а не в других, даже если эти фреймы содержат документы из одного источника.

Спецификации

Спецификация
Стандарт API полноэкранного режима # permissions-policy-integration

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`fullscreen`	62	79	74 ["Только поддерживается через атрибут `allow` на элементах `<iframe>`", "Перед Firefox 80 применение `fullscreen` к элементу `<iframe>` (т.е. через атрибут `allow`) не работало, если также не был присутствующим атрибут `allowfullscreen`."]	Нет	49	Нет	62	62	79 ["Только поддерживается через атрибут `allow` на элементах `<iframe>`", "Перед Firefox 80 применение `fullscreen` к элементу `<iframe>` (т.е. через атрибут `allow`) не работало, если также не был присутствующим атрибут `allowfullscreen`."]	46	Нет	8.0

См. также

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Feature-Policy/fullscreen