Document：fullscreenEnabled 属性

Document 接口上的只读属性 fullscreenEnabled 表明全屏模式是否可用。

全屏模式仅适用于不包含任何窗口化插件的页面，或者页面中的所有 <iframe> 元素都设置了 allowfullscreen 属性。

尽管这个属性是只读的，但如果修改它，即使在严格模式下也不会抛出错误；它的 setter 方法是空操作将被忽略。

值

一个布尔值，如果调用 Element.requestFullscreen() 能进入全屏模式，则为 true。如果全屏模式不可用，则该值为 false。

示例

在下面的示例中，在 <video> 元素尝试请求全屏模式之前，检查 fullscreenEnabled 的值，以避免在不可用时调用 Element.requestFullscreen() 方法。

js
function requestFullscreen() {
  if (document.fullscreenEnabled) {
    videoElement.requestFullscreen();
  } else {
    console.log("你的浏览器现在无法使用全屏模式");
  }
}

规范

Specification
Fullscreen API Standard
# ref-for-dom-document-fullscreenenabled①

浏览器兼容性

BCD tables only load in the browser

参见