[3] Document オブジェクトの visibilityState 属性は、文書が表示されているかどうかの状態を返します。

仕様書

可視性状態

[12] 最上位閲覧文脈の文書は、 可視性状態visibility stateを持ちます >>11。

[7] 可視性状態は、次のいずれかです >>11。 それぞれ、列挙型 VisibilityState >>11 で対応する値を持ちます。

s
可視性状態
c
VisibilityState
d
意味
s
隠れdocument.hiddenhidden
c
hiddendocument.hidden
d
文書は、画面screen上でまったく可視状態にありません。
s
可視visible
c
visibledocument.hidden
d
文書は、少なくても一部は画面上で可視状態にあります。
s
事前レンダリングprerender
c
prerender
d
文書は事前レンダリングモードで読み込まれ、まだ可視状態になっていません。
[19] 状態の判定については、可視を参照。[23] 値の変化の挙動については visibilitychange を参照。

[14] かつては unloaded もありました >>2。 vendor prefix 付きの値も認められていました >>2。

取得器

[15] Document インターフェイスの visibilityState IDL属性は、 文脈オブジェクトについて可視性状態を決定する手順を実行しなければなりません >>13。 この属性は読み取り専用で、列挙型 VisibilityState の値を返します >>13。

[16] 文脈文書の可視性状態を決定する手順steps to determine the visibility state >>13 は、次のようにします。

  1. [6] 文脈文書の閲覧文脈が null なら、
    1. [21] hidden を返し、ここで停止します。
  2. [4] 文書を、文脈文書の閲覧文脈の最上位閲覧文脈の文書に設定します。 >>13
  3. [17] 文書の defaultView が null なら、
    1. [22] hidden を返し、ここで停止します。 >>13
  4. [18] 文書の可視性状態の VisibilityState を返します。 >>13

[9] 値の決定については >>7 の各項を、値の変化のタイミングについては visibilitychange の項をご覧ください。[20] この手順はバイブレーションパターンの処理からも呼び出されます。

歴史

[5] Page Visibility 仕様で追加されました。

[10] 当初は各レンダリング・エンジンで webkitVisibilityState、 mozVisibilityState、msVisibilityState という名前で実装されていました。

関連

[8] boolean で値を返す document.hidden 属性もあります。