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

* 仕様書

[REFS[
- [2] [CITE@en[Page Visibility]] ([TIME[2013-05-20 14:09:47 +09:00]] 版) <https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-visibilitystate>
]REFS]

* WebIDL 定義

[FIG[
[4] [SRC[>>2]]
[PRE(IDL code)[
enum [DFN[[[VisibilityState]]]] { "[[hidden]]", "[[visible]]", "[[prerender]]", "[[unloaded]]" };
partial interface [[Document]] {
  [[readonly attribute]] [[VisibilityState]] [DFN[[[visibilityState]]]];
};
]PRE]
]FIG]

* 取得器

[6] [[Page Visibility]] で定義されている4つの値か [[vendor prefix]] 付きの値のいずれかを返さなければ[['''なりません''']]
[SRC[>>2]]。

[9] 値の変化のタイミングについては [CODE(DOMe)@en[[[visibilitychange]]]] の項をご覧ください。

* 属性値

[7] [[属性値]]には次のものがあります。
[FIG[
- [CODE(DOM)@en[[[hidden]]]] [SRC[>>2]]
- [CODE(DOM)@en[[[visible]]]] [SRC[>>2]]
- [CODE(DOM)@en[[[prerender]]]] [SRC[>>2]]
- [CODE(DOM)@en[[[unloaded]]]] [SRC[>>2]]
]FIG]

* 歴史

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

[REFS[
- [1] [CITE@en[Page Visibility]]
( ([TIME[2011-06-01 21:46:24 +09:00]] 版))
<http://www.w3.org/TR/2011/WD-page-visibility-20110602/>
]REFS]

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

* 関連

[8] [[boolean]] で値を返す [CODE(JS)@en[[[document.hidden]]]] [[属性]]もあります。