{{DefaultAPISidebar("Fullscreen API")}}
全屏 API 为使用用户的整个屏幕展现网络内容提供了一种简单的方式，并且在不需要时退出全屏模式。这种 API 让你可以简单地控制浏览器，使得一个元素与其子元素，如果存在的话，可以占据整个屏幕，并在此期间，从屏幕上隐藏所有的浏览器用户界面以及其他应用。
可以在全屏 API 指南这篇文章了解更多细节。
注意：当前并不是所有的浏览器都支持该 API，大多数浏览器需要使用供应商前缀或者尚未实现该规范。下面的浏览器兼容性表 {{anch("Browser compatibility")}} 可以看到各个浏览器对此的支持（你也可以使用 Fscreen 来提供跨浏览器 API 访问）。
全屏 API 没有它自己的接口实现。相反，它提供了一些其他接口以供实现全屏所需的方法、属性、事件处理函数。接下来会列出所有细节。
全屏 API 在 {{DOMxRef("Document")}} 和 {{DOMxRef("Element")}} 接口中增加了一些方法，可用于允许打开关闭全屏模式。
{{DOMxRef("Document")}} 提供了可以用于判断是否支持和启用全屏模式的属性，也能得知现在是否处在全屏模式、哪一个元素在使用屏幕等信息。
fullscreenElement 属性提供了当前在 DOM （或者 shadow DOM）里被展示为全屏模式的 {{DOMxRef("Element")}}，如果这个值为 null，文档不处于全屏模式。fullscreenEnabled 属性提供了启用全屏模式的可能性。当它的值是 false 的时候，表示全屏模式不可用（可能的原因有 "fullscreen" 特性不被允许，或全屏模式不被支持等 ）。Fullscreen API 定义了两个事件，可用于检测全屏模式的打开和关闭，以及在全屏和窗口模式之间切换过程中发生的错误。{{DOMxRef("Document")}} 和 {{DOMxRef("Element")}} 接口提供了这些事件的事件处理函数。
注意：这些事件处理函数特性不可以当成 HTML 内容属性来使用。 换句话说，你无法在 HTML 内容中为 {{Event("fullscreenchange")}} 和 {{Event("fullscreenerror")}} 指定事件处理程序，你必须通过 JavaScript 代码添加它们。
true，否则为 false。Note：请改用 {{DOMxRef("ShadowRoot")}} 或 {{DOMxRef("Document")}} 上的 {{DOMxRef("Document.fullscreenElement", "fullscreenElement")}} 属性；如果它不是 null，则它是就是当前在全屏模式下显示的元素。
全屏 API 定义了两个事件：1.可用来检测全屏模式何时打开和关闭。2.在全屏模式和窗口模式之间切换过程中何时发生错误。
全屏模式可由功能策略（ Feature Policy）控制。全屏模式功能由字符串“full screen”标识，默认的允许列表值为“self”，这意味着在顶级文档上下文 以及 从与顶级文档相同的源加载的嵌套上下文中允许使用全屏模式。
请参阅使用功能策略（ Feature Policy ）以了解有关使用功能策略控制对API的访问的更多信息。
用户通过按 ESC 键（或 F11）即可退出全屏模式，而不是等着站点或应用的代码来做这件事。确定你在你的用户界面里提供合适的界面元素来告知用户这个可选项。
注意：当处在全屏模式中，浏览其他页面，切换标签页，或者切换到其他应用（例如使用 Alt-Tab）也会导致退出全屏模式。
在这个例子中，网页中显示了一个视频。按下 Enter 键让用户在视频的窗口显示和全屏显示之间切换。
当页面加载时，这段代码会运行，设置一个事件监听器以监听 Enter 键。
document.addEventListener("keydown", function(e) {
if (e.keyCode == 13) {
toggleFullScreen();
}
}, false);
当用户按下 Enter 键时，这段代码会被调用，像上面看到的那样。
function toggleFullScreen() {
if (!document.fullscreenElement) {
document.documentElement.requestFullscreen();
} else {
if (document.exitFullscreen) {
document.exitFullscreen();
}
}
}
这段代码首先检查 document 的 fullscreenElement 属性的值（亦要检查带有前缀 moz、ms、webkit）。如果其为 null，文档当前处于窗口模式中，所以我们需要切换到全屏模式。通过调用 element.requestFullscreen()，可以切换到全屏模式。
如果全屏模式已经激活（fullscreenElement 不为 null），我们可以调用 document.exitFullscreen()（或其前缀化的版本，这取决于你使用的浏览器）。
| 规范 | 状态 | 备注 |
|---|---|---|
| {{SpecName("Fullscreen")}} | {{Spec2("Fullscreen")}} | 初始版本. |
所有的浏览器都实现了这个API。然而一些带有前缀的实现在拼写上略微有些差别；例如，不同于 requestFullscreen()，存在一个 MozRequestFullScreen()。
{{Compat("api.Document.fullscreen")}}
{{Compat("api.Document.fullscreenEnabled")}}