From dcbf248c9d2974891a7dac520ed36d546940be86 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Thu, 30 Jan 2025 16:53:42 +0800
Subject: [PATCH] [zh-CN]: Add translation for `Permissions-Policy: fullscreen`

---
 .../permissions-policy/fullscreen/index.md    | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 files/zh-cn/web/http/headers/permissions-policy/fullscreen/index.md

diff --git a/files/zh-cn/web/http/headers/permissions-policy/fullscreen/index.md b/files/zh-cn/web/http/headers/permissions-policy/fullscreen/index.md
new file mode 100644
index 00000000000000..60169def15846e
--- /dev/null
+++ b/files/zh-cn/web/http/headers/permissions-policy/fullscreen/index.md
@@ -0,0 +1,69 @@
+---
+title: "Permissions-Policy: fullscreen"
+slug: Web/HTTP/Headers/Permissions-Policy/fullscreen
+l10n:
+  sourceCommit: 7cd4706990ab95794415aee05ba0a9662e742a17
+---
+
+{{HTTPSidebar}}{{SeeCompatTable}}
+
+HTTP {{HTTPHeader("Permissions-Policy")}} 标头 `fullscreen` 指令控制当前文档是否允许使用 {{domxref('Element.requestFullscreen()')}}。
+
+默认情况下，顶级文档及其同源子框架可以请求并进入全屏模式。此指令允许或阻止跨源框架使用全屏模式。这包括同源框架。
+
+具体而言，如果定义的策略阻止使用此功能，则 {{domxref('Element.requestFullscreen', "requestFullscreen()")}} 调用将返回一个 {{jsxref('Promise')}} 并以 {{jsxref('TypeError')}} 拒绝。
+
+> [!NOTE]
+> 如果此指令（即通过 `allow` 属性）和 `allowfullscreen` 属性都存在于 `<iframe>` 元素上，则该指令优先。
+
+## 语法
+
+```http
+Permissions-Policy: fullscreen=<allowlist>;
+```
+
+- `<allowlist>`
+  - : 允许使用该特性的来源列表。有关更多详细信息，参阅 [`Permissions-Policy` > 语法](/zh-CN/docs/Web/HTTP/Headers/Permissions-Policy#语法)。
+
+## 默认策略
+
+`fullscreen` 的默认允许列表是 `self`。
+
+## 示例
+
+### 一般示例
+
+SecureCorp Inc. 希望在除与其同源和源为 `https://example.com` 的浏览上下文之外的所有浏览上下文中禁用全屏 API。它可以通过提供以下 HTTP 响应标头来定义权限策略以实现此目的：
+
+```http
+Permissions-Policy: fullscreen=(self "https://example.com")
+```
+
+### 使用 \<iframe> 元素
+
+FastCorp Inc. 希望禁用除特定 `<iframe>` 之外的所有跨源子框架的 `fullscreen`。它可以通过提供以下 HTTP 响应标头来定义权限策略来实现此目的：
+
+```http
+Permissions-Policy: fullscreen=(self)
+```
+
+然后在 `<iframe>` 元素上包含一个 {{HTMLElement('iframe','allow','#属性')}} 属性：
+
+```html
+<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>
+```
+
+iframe 属性可以选择性地启用某些框架中的功能，而不启用其他框架中的功能，即使这些框架包含同源的文档。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{HTTPHeader("Permissions-Policy")}} 标头
+- [权限策略](/zh-CN/docs/Web/HTTP/Permissions_Policy)