Document: fullscreenEnabled 属性

有限可用性

此功能不是基线，因为它在一些最广泛使用的浏览器中不起作用。

Document 接口上的只读 fullscreenEnabled 属性指示是否可以使用全屏模式。

全屏模式仅适用于其任何文档中没有窗口插件的页面，并且所有包含该文档的 <iframe> 元素都已设置其 allowfullscreen 属性。

虽然此属性是只读的，但如果它被修改（即使在严格模式下），它也不会抛出异常；setter 是一个无操作，它将被忽略。

值

如果文档及其内部元素可以通过调用 Element.requestFullscreen() 进入全屏模式，则此布尔值是 true。如果全屏模式不可用，则此值是 false。

示例

在此示例中，在尝试为 <video> 元素请求全屏模式之前，会检查 fullscreenEnabled 的值，以避免在不可用时进行尝试。

js
function requestFullscreen() {
  if (document.fullscreenEnabled) {
    videoElement.requestFullscreen();
  } else {
    console.log("Your browser cannot use fullscreen right now");
  }
}

规范

规范
全屏 API 标准
# ref-for-dom-document-fullscreenenabled①

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅