文档:fullscreenElement 属性

可用性有限

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

Document.fullscreenElement 只读属性返回当前在此文档中以全屏模式呈现的 Element,或者在当前未使用全屏模式时返回 null

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

当前处于全屏模式的 Element 对象;如果当前文档未使用全屏模式,则返回值为 null。如果存在多个全屏元素,则返回最顶层(最近请求的)元素。

示例

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

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

规范

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

浏览器兼容性

另见