/
580.txt
75 lines (54 loc) · 2.68 KB
/
580.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
[3] [CODE(DOMi)@en[[[Document]]]] [[オブジェクト]]の [DFN[[CODE(DOMa)@en[[[visibilityState]]]]]]
[[属性]]は、[[文書]]が表示されているかどうかの状態を返します。
* 仕様書
[REFS[
- [11] [CITE@en[Page Visibility (Second Edition)]] ([TIME[2015-11-13 18:23:52 +09:00]] 版) <https://w3c.github.io/page-visibility/#h-visibility-states-and-the-visibilitystate-enum>
]REFS]
* 可視性状態
[12] [[最上位閲覧文脈]]の[F[[[文書]]]]は、[F[[RUBY[[[可視性状態]]]@en[visibility state]]]]を持ちます
[SRC[>>11]]。
[7] [[可視性状態]]は、次のいずれかです [SRC[>>11]]。
それぞれ、[[列挙型]] [DFN[[CODE[[[VisibilityState]]]]]] [SRC[>>11]] で対応する値を持ちます。
[FIG(table)[
:s:可視性状態
:c:[CODE[[[VisibilityState]]]]
:d:意味
:s:[RUBYB[[[隠れ]]]@en[hidden]]
:c:[CODE[[[hidden]]]]
:d:[[文書]]は、[RUBYB[[[画面]]]@en[screen]]上でまったく可視状態にありません。
:s:[RUBYB[[[可視]]]@en[visible]]
:c:[CODE[[[visible]]]]
:d: [[文書]]は、少なくても一部は画面上で可視状態にあります。
:s: [RUBYB[[[事前レンダリング]]]@en[[[prerender]]]]
:c: [CODE[[[prerender]]]]
:d: [[文書]]は事前レンダリングモードで読み込まれ、まだ可視状態になっていません。
]FIG]
[HISTORY[
[14] かつては [CODE[[[unloaded]]]] もありました [SRC[>>2]]。
]HISTORY]
* WebIDL 定義
[FIG[
[4] [SRC[>>2]]
[PRE(IDL code)[
partial interface [[Document]] {
[[readonly attribute]] [[VisibilityState]] [DFN[[[visibilityState]]]];
};
]PRE]
]FIG]
* 取得器
[6] [[Page Visibility]] で定義されている4つの値か [[vendor prefix]] 付きの値のいずれかを返さなければ[['''なりません''']]
[SRC[>>2]]。
[9] 値の変化のタイミングについては [CODE(DOMe)@en[[[visibilitychange]]]] の項をご覧ください。
* 歴史
[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/>
- [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]
[10] 当初は各[[レンダリング・エンジン]]で [DFN[[CODE(DOMa)@en[[[webkitVisibilityState]]]]]]、
[DFN[[CODE(DOMa)@en[[[mozVisibilityState]]]]]]、[DFN[[CODE(DOMa)@en[[[msVisibilityState]]]]]]
という名前で実装されていました。
* 関連
[8] [[boolean]] で値を返す [CODE(JS)@en[[[document.hidden]]]] [[属性]]もあります。