文档: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");
  }
}

规范

规范
Fullscreen API
# ref-for-dom-document-fullscreenenabled①

浏览器兼容性

另见