Document: visibilityState 属性

Document.visibilityState 只读属性返回文档的可见性。它可以用来检查文档是否在后台或最小化窗口中,或者是否以其他方式对用户不可见。

当此属性的值发生变化时,visibilitychange 事件将被发送到 Document

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

具有以下值之一的字符串

visible

页面内容可能至少部分可见。实际上,这意味着页面是非最小化窗口的前景选项卡。

hidden

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

示例

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

规范

规范
HTML 标准
# dom-document-visibilitystate

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅