文件: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

瀏覽器相容性

另見