大网数据广告活动
Web 标准与前端开发

Document:FullScreenElement 属性

· 52CE 我爱测

`Document.fullscreenElement`** 只读属性返回当前页面中以全屏模式呈现的 Element,如果当前页面未使用全屏模式,则返回 `null`。

Fullscreen API

Document.fullscreenElement 只读属性返回当前页面中以全屏模式呈现的 Element,如果当前页面未使用全屏模式,则返回 null。

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

值

返回当前处于全屏模式的 Element 对象;如果当前页面未使用全屏模式,则返回 null。如果有多个元素处于全屏模式下,则返回最顶层(最近请求)的元素。

示例

这个示例展示了一个名为 isVideoInFullscreen() 的函数,该函数查看 fullscreenElement 返回的值;如果文档处于全屏模式(fullscreenElement 不为 null)并且全屏元素的 Node.nodeName 为 VIDEO,表示为 video 元素,则函数返回 true,表示视频处于全屏模式。

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。