Document: fullscreenElement 属性

有限可用性

此功能不是基线功能,因为它在一些最常用的浏览器中无法正常工作。

Document.fullscreenElement 只读属性返回当前在此文档中以全屏模式显示的Element,如果当前未使用全屏模式,则返回 null

尽管此属性是只读的,但如果修改它(即使在严格模式下),也不会抛出错误;设置器是一个空操作,将被忽略。

当前处于全屏模式的Element 对象;如果 document 当前未使用全屏模式,则返回 null

示例

此示例提供了一个函数 isVideoInFullscreen(),它查看 fullscreenElement 返回的值;如果文档处于全屏模式(fullscreenElement 不是 null)并且全屏元素的nodeNameVIDEO,表示一个<video> 元素,则该函数返回 true,表示视频处于全屏模式。

js
function isVideoInFullscreen() {
  if (document.fullscreenElement?.nodeName === "VIDEO") {
    return true;
  }
  return false;
}

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅