Document: visibilityState プロパティ
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