Document: visibilityState プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Document.visibilityState は読み取り専用プロパティで、この文書の可視性を返します。文書がバックグラウンドにあるか、最小化されたウィンドウにあるか、あるいはユーザーから見えないかどうかを調べるために使用することができます。
このプロパティを変更すると、visibilitychange イベントが Document へ送られます。
Document.hidden プロパティは、ページが非表示かどうかを判断する別の方法を提供します。
値
利用可能な値は次のとおりです。
visible-
ページのコンテンツは、少なくとも部分的に表示される場合があります。実際には、これはページが最小化されていないウィンドウのフォアグラウンドタブであることを意味します。
-
ページのコンテンツはユーザーには表示されません。実際には、これは文書がバックグラウンドタブまたは最小化されたウィンドウの一部であるか、 OS の画面ロックがアクティブであることを意味します。
例
js
document.addEventListener("visibilitychange", () => {
console.log(document.visibilityState);
// 振る舞いを変更します...
});
仕様書
| Specification |
|---|
| HTML Standard # dom-document-visibilitystate |
ブラウザーの互換性
BCD tables only load in the browser