Document.visibilityState
Document.visibilityState
は読み取り専用プロパティで、文書 (document
) の可視性、つまりこの要素がこれで見えるようになったのはどのコンテキストであるかを返します。文書がバックグラウンドにあるのか、非表示のタブにあるのか、プリレンダリングのためにのみ読み込まれるのかを知るのに有用です。
利用可能な値は次のとおりです。
visible
-
ページのコンテンツは、少なくとも部分的に表示される場合があります。実際には、これはページが最小化されていないウィンドウのフォアグラウンドタブであることを意味します。
-
ページのコンテンツはユーザーには表示されません。実際には、これは文書がバックグラウンドタブまたは最小化されたウィンドウの一部であるか、 OS の画面ロックがアクティブであることを意味します。
このプロパティの値が変更されると、 visibilitychange
イベントが Document
に送信されます。
これの一般的な用途は、文書がプリレンダリングされている場合に一部のアセットのダウンロードを防止したり、文書がバックグラウンドにあるか最小化されている場合に一部のアクティビティを停止したりすることです。
構文
js
document.visibilityState
例
js
document.addEventListener("visibilitychange", () => {
console.log(document.visibilityState);
// 振る舞いを変更します...
});
仕様書
Specification |
---|
HTML Standard # dom-document-visibilitystate |
ブラウザーの互換性
BCD tables only load in the browser