大网数据广告活动
Web 标准与前端开发

Permissions-Policy: fullscreen

· 52CE 我爱测

HTTP Permissions-Policy 标头的 `fullscreen` 指令控制当前文档是否允许使用 Element.requestFullscreen()。

HTTP Permissions-Policy 标头的 fullscreen 指令控制当前文档是否允许使用 Element.requestFullscreen()。

默认情况下,顶级文档及其同源子框架可以请求并进入全屏模式。此指令允许或阻止跨源框架使用全屏模式。这包括同源框架。

具体而言,如果定义的策略阻止使用此功能,则 Element.requestFullscreen 调用将返回一个 Promise 并以 TypeError 拒绝。

[!NOTE] 如果此指令(即通过 allow 属性)和 allowfullscreen 属性都存在于 <iframe> 元素上,则该指令优先。

语法

Permissions-Policy: fullscreen=<allowlist>;

默认策略

fullscreen 的默认允许列表是 self。

示例

一般示例

SecureCorp Inc. 希望在除与其同源和源为 https://example.com 的浏览上下文之外的所有浏览上下文中禁用全屏 API。它可以通过提供以下 HTTP 响应标头来定义权限策略以实现此目的:

Permissions-Policy: fullscreen=(self "https://example.com")

使用 <iframe> 元素

FastCorp Inc. 希望禁用除特定 <iframe> 之外的所有跨源子框架的 fullscreen。它可以通过提供以下 HTTP 响应标头来定义权限策略来实现此目的:

Permissions-Policy: fullscreen=(self)

然后在 <iframe> 元素上包含一个 iframe 属性:

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

iframe 属性可以选择性地在某些框架中的启用特性,而不在其他框架中启用特性,即使这些框架包含同源的文档。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。