[2] [CODE(DOMi)@en[[[Document]]]] [[オブジェクト]]の [DFN[[CODE(DOMa)@en[[[hidden]]]]]] [[属性]]は、 [[文書]]が表示されているかを返します。 [16] [CODE(DOMi)@en[[[Document]]]] [[オブジェクト]]の [CODE(DOMa)@en[[[visibilityState]]]] [[属性]]の値 [DFN[[CODE(DOM)@en[[[hidden]]]]]] は[[文書]]が隠れていることを表します。 [17] これら2つの「hidden」の意味は若干異なっています。 * 仕様書 [REFS[ - [1] [CITE@en[Page Visibility]] ([TIME[2013-05-20 13:53:52 +09:00]] 版) - [18] [CITE@en[Page Visibility]] ([TIME[2013-05-20 14:16:53 +09:00]] 版) ]REFS] * WebIDL 定義 [FIG[ [3] [SRC[>>1]] [PRE(IDL code)[ partial interface [[Document]] { [[readonly attribute]] [[boolean]] hidden; }; ]PRE] ]FIG] * 取得器 ([CODE(DOMa)@en[hidden]] 属性) [4] [[最上位閲覧文脈]]に含まれている [CODE(DOMi)@en[[[Document]]]] がまったく見えないなら[[真]]、 どこかの[[画面]]に一部分でも表示されているなら[[偽]]を返さなければ[['''なりません''']] [SRC[>>1]]。 ;; [6] 当該 [CODE(DOMi)@en[[[Document]]]] が直接含まれている[[閲覧文脈]]ではなく、[[最上位閲覧文脈]]によって決まります。 [5] [CODE(DOMi)@en[[[Document]]]] の [CODE(DOMa)@en[[[defaultView]]]] が [[null]] なら、[[真]]を返さなければ[['''なりません''']] [SRC[>>1]]。 [7] 通常[[全画面]]で表示するような[[アクセシビリティ・ツール]]もあったりしますから、 [[Webブラウザー]]が[[最小化]]されておらず他の[[アプリケーション]]に完全に隠れてしまっているような場合であれば[[偽]]を返しても[['''構いません''']] [SRC[>>1]]。 [EG[ [8] 例えば次の場合に[[真]]を返します。 - [9] [[最小化]]されている場合 [SRC[>>1]] - [10] 裏の[[タブ]]になっている場合 [SRC[>>1]] - [11] [[unload]] しようとしている場合 [SRC[>>1]] - [12] [[session history entry]] を探索しようとしている場合 [SRC[>>1]] - [13] [[OS]] の[[ロック画面]]が表示されている場合 [SRC[>>1]] ]EG] * [CODE(DOMa)@en[visibilityState]] 属性の値 [CODE(DOM)@en[hidden]] [19] [[最上位閲覧文脈]]に含まれている [CODE(DOMi)@en[[[Document]]]] がまったく見えないなら [CODE(DOMa)@en[[[visibilityState]]]] [[属性]]は [CODE(DOM)@en[[[hidden]]]] を返さなければ[['''なりません''']]。ただし >>7 の場合は [CODE(DOM)@en[[[visible]]]] を返して[['''構いません''']]。 [SRC[>>18]] [20] >>19 の規定からすると [CODE(DOMa)@en[[[hidden]]]] [[属性]]が[[真]]なら [CODE(DOMa)@en[[[visibilityState]]]] [[属性]]は必ず [CODE(DOM)@en[[[hidden]]]] になりそうなものですが、 >>11 の場合に [CODE(DOM)@en[[[unloaded]]]] という別の値が用意されています。また [CODE(DOM)@en[[[prerender]]]] という値も用意されています。 更に [[vendor prefix]] のついた値も認められており、厳密に解釈すると >>19 の規定に反してしまう可能性があります。 * 歴史 [15] [[Page Visibility]] 仕様により追加されました。 [[WebKit]] では [DFN[[CODE(DOMa)@en[[[webkitHidden]]]]]] として実装されています [TIME[2013-05-20T14:04:38.00Z]]。 * 関連 [14] [[要素]]の [CODE(DOMa)@en[[[hidden]]]] [[属性]]とは関係ありません。