文档:visibilityState 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

Document.visibilityState 只读属性返回文档的可见性。它可以用来检查文档是否处于后台、窗口最小化,或者用户当前无法看到它。

当此属性的值发生变化时,会向 Document 发送 visibilitychange 事件。

Document.hidden 属性提供了另一种确定页面是否隐藏的方式。

一个字符串,其值可能为以下之一:

visible

页面内容至少部分可见。在实际应用中,这意味着页面位于非最小化窗口的前台选项卡中。

hidden

页面内容对用户不可见。在实际应用中,这意味着文档是后台选项卡,或者是一个最小化窗口的一部分,或者操作系统屏幕锁定处于激活状态。

示例

js
document.addEventListener("visibilitychange", () => {
  console.log(document.visibilityState);
  // Modify behavior…
});

规范

规范
HTML
# dom-document-visibilitystate

浏览器兼容性

另见