696.txt

[15] [DFN[[CODE(JS)@en[[[document.all]]]]]] は、[[文書]]中のすべての[[要素]]を含む[[コレクション]]です。
この[[オブジェクト]]は [[IE4 DOM]] の一部であり、現在では[[廃止]]状態とされています [SRC[>>14]] が、
[[Webブラウザー]]が実装しなければならない [SRC[>>14]] 機能の一つとされており、
すべての [[Webブラウザー]]が対応しています。

* 仕様書

[REFS[
- [14] '''[CITE@en-US-x-hixie[HTML Standard]] ([TIME[2014-04-03 03:44:44 +09:00]] 版) <http://www.whatwg.org/specs/web-apps/current-work/#dom-document-all>'''
- [13] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2014-04-03 03:44:44 +09:00]] 版) <http://www.whatwg.org/specs/web-apps/current-work/#htmlallcollection-0>
- [27] [CITE@en-US[DOM Standard]] ([TIME[2014-03-20 17:08:41 +09:00]] 版) <http://dom.spec.whatwg.org/#interface-htmlcollection>
]REFS]

* [CODE(DOMi)@en[Document]] オブジェクト [CODE(DOMa)@en[all]] 属性 (DOM)

[16] [CODE(DOMi)@en[[[Document]]]] [[インターフェイス]]の [CODE(DOMa)@en[[[all]]]] [[属性]]は、
[CODE(DOMi)@en[[[HTMLAllCollection]]]] [[オブジェクト]]を返す[[読み取り専用]]の[[IDL属性]]です。
この[[オブジェクト]]は当該 [CODE(DOMi)@en[[[Document]]]] を[[根]]とし、
すべての[[要素]]に[[一致]]する[[フィルター]]を持つものでなければ[['''なりません''']]。
[SRC[>>14]]

[37] この[[属性]]は、毎回同じオブジェクトを返します。
つまり[[文書]]にはちょうど1つだけ [CODE(DOMa)@en[[[all]]]] [[オブジェクト]]が存在します。

* [CODE(DOMi)@en[HTMLAllCollection]] インターフェイス (DOM)

[23] [DFN[[CODE(DOMi)@en[[[HTMLAllCollection]]]]]] [[インターフェイス]]は[[文書環境]]で [[JavaScriptに晒され]]ています。

[38] この[[オブジェクト]]は[[生きて]]おり、[[DOM木]]に対する変更が即時反映されます。

;; [45] かつては [CODE(DOMi)@en[[[HTMLCollection]]]] を[[継承]]していましたが、
現在は独立しています [SRC[>>44]]。

** メンバー

[24] [CODE(DOMi)@en[[[HTMLAllCollection]]]] には、[[継承]]するものも含めて次のメンバーがあります。

[FIG(short list)[
- [CODE(DOMm)@en[item][item (DOM)]]
- [CODE(DOMa)@en[length][length (DOM)]]
- [CODE(DOMm)@en[[[namedItem]]]]
- [[supported property indices]]
- [[supported property names]]
- [[legacy caller]]
]FIG]

[25] 数値インデックス ([[配列]]風アクセス) は、 [CODE(DOMm)@en[[[item]]]] [[メソッド]]の呼び出しと等価です
[SRC[>>13]]。 [CODE(DOMm)@en[[[item]]]] 
[[メソッド]]は[[数値]]を引数として呼び出すと[[コレクション]]中の[[木順]]で指定された位置の[[要素]]を返します
[SRC[>>13]]。

[26] 名前インデックス ([[オブジェクト]]風アクセス) と [[legacy caller]]
([[メソッド]]としての実行) は、 [CODE(DOMm)@en[[[namedItem]]]] [[メソッド]]の呼び出しと等価です
[SRC[>>13]]。 [CODE(DOMm)@en[[[item]]]] [[メソッド]]を[[文字列]]引数で呼び出した場合もこちらと等価です
[SRC[>>13]]。 [CODE(DOMm)@en[[[namedItem]]]] [[メソッド]]は[[コレクション]]中で指定された名前の[[要素]]を返します
[SRC[>>13]]。

[29] [CODE(DOMm)@en[[[namedItem]]]] [[メソッド]]の引数が[[空文字列]]の時と、[[引数]]と同じ名前の[[要素]]がないときは、
[CODE(IDL)@en[[[null]]]] を返さなければ[['''なりません''']] [SRC[>>13]]。

[30] [CODE(DOMm)@en[[[namedItem]]]] [[メソッド]]の引数で指定された[[要素]]が複数ある時は、
当該 [CODE(DOMi)@en[[[HTMLAllCollection]]]] を更に指定された名前で絞り込んだ
[CODE(DOMi)@en[[[HTMLCollectoon]]]] [[オブジェクト]]を返さなければ[['''なりません''']]。 [SRC[>>13]]

;; [31] 返されるのは [CODE(DOMi)@en[[[HTMLAllCollection]]]] ではありません。

;; [32] 同じ名前の引数に対して同じオブジェクトを返さなければならないという規定は無いようです。

* 要素の名前

[33] [CODE(DOMi)@en[[[HTMLAllCollection]]]] における[[要素]]の[[名前]]とは、
[CODE(HTMLa)@en[[[name]]]] [[属性値]]と [[ID]] のことをいいます。

[34] ただし [CODE(HTMLa)@en[[[name]]]] [[属性]]が用いられるのは
[DFN[[RUBYB[[[「all」名前付き要素]]]@en["all"-named elements]]]]に限られます。
「all」名前付き要素とは、 [[HTML]] の
[FIG(short list)[
- [CODE(HTMLe)@en[[[a]]]]
- [CODE(HTMLe)@en[[[applet]]]]
- [CODE(HTMLe)@en[[[button]]]]
- [CODE(HTMLe)@en[[[embed]]]]
- [CODE(HTMLe)@en[[[form]]]]
- [CODE(HTMLe)@en[[[frame]]]]
- [CODE(HTMLe)@en[[[frameset]]]]
- [CODE(HTMLe)@en[[[iframe]]]]
- [CODE(HTMLe)@en[[[img]]]]
- [CODE(HTMLe)@en[[[input]]]]
- [CODE(HTMLe)@en[[[map]]]]
- [CODE(HTMLe)@en[[[meta]]]]
- [CODE(HTMLe)@en[[[object]]]]
- [CODE(HTMLe)@en[[[select]]]]
- [CODE(HTMLe)@en[[[textarea]]]]
]FIG]
... です [SRC[>>13]]。

;; [40] このリストは[[ブラウザー]]によって相違がありますが、 
[[HTML Standard]] は広めにとっているようです。
コメントに「keygen?」ともあります [SRC[>>39]]。

[36] ただし[[空文字列]]は名前とはみなされません。

[35] [[supported property names]] においては、[[木順]]で、重複する場合は最初の方が採用されます。
[CODE(HTMLa)@en[[[id]]]] と [CODE(HTMLa)@en[[[name]]]] がある[[要素]]があれば
[CODE(HTMLa)@en[[[id]]]] が先に現れたと考えます。 [SRC[>>13]]

* JavaScript 束縛

[17] [CODE(JS)@en[[[document.all]]]] [[オブジェクト]]に [[JavaScript]] [CODE(JS)@en[[[ToBoolean()]]]] 
[[演算]]を適用すると、[[偽]]を返さなければ[['''なりません''']]。 [SRC[>>14]]

[18] [CODE(JS)@en[[[document.all]]]] [[オブジェクト]]に [[JavaScript]] の[[抽象等値性比較]]
([CODE(JS)@en[[[==]]]] や [CODE(JS)[[[!=]]]]
の[[演算子]]) を適用すると、[CODE(JS)@en[[[undefined]]]] や [CODE(JS)@en[[[null]]]] 
と同じように振る舞わなければ[['''なりません''']]。 [SRC[>>14]]

;; [19] [CODE(JS)[[[===]]]] や [CODE(JS)[[[!==]]]] に関しては、普通の[[オブジェクト]]と同じように振る舞います。

[20] [CODE(JS)@en[[[document.all]]]] [[オブジェクト]]に [[JavaScript]] の [CODE(JS)@en[[[typeof]]]]
[[演算子]]を適用すると、[[文字列]] [CODE(JS)@en[[[undefined]]]] を返さなければ[['''なりません''']]。 [SRC[>>14]]

[21] これらの要件は、通常の[[オブジェクト]]の動作とは異なりますが、歴史的経緯のために必要
[SRC[>>14]] とされています。

[HISTORY[
[22] かつて [CODE(JS)@en[[[document.all]]]] は [[IE]] のみが実装していたため、 [[IE]]
であるかどうかの判別に用いられることがありました。すなわち、
[PRE(JS example code)[
if (document.all) {
  // for IE
} else {
  // for non-IE
}
]PRE]
... で [[IE]] 以外の[[近代的ブラウザー]]は後者が実行される必要がありました。一方で、 [[IE]]
のみに対応していて [CODE(JS)@en[[[document.all]]]] が実装されていなければ動作しない
[[Webサイト]]も存在していました。この両方のパターンに対応するため、 [CODE(JS)@en[[[document.all]]]]
[[オブジェクト]]は条件式においては [CODE(JS)@en[[[undefined]]]] と同じように動作する実装がなされました。
現在では [[IE]] も[[近代的ブラウザー]]と [[HTML Standard]] に従っています。
]HISTORY]

[28] これらは [CODE(DOMi)@en[[[HTMLAllCollection]]]] ではなく [CODE(JS)@en[[[document.all]]]]
について要求されているようですが、 [CODE(JS)@en[[[document.all]]]] 以外で [CODE(DOMi)@en[[[HTMLAllCollection]]]]
は使われていないので、実質的にそれと同じです。

* 歴史

** IE4

[49] [CODE(JS)@en[document.all]] は [[IE4 DOM]] で追加されました。 [[Netscape]] [[DOM0]] の
[CODE(JS)@en[document.links]] や [CODE(JS)@en[document.forms]]
などに対して、すべての種別の[[要素]]、という意味で「all」と命名されたものと思われます。

[51] その後標準化された [[DOM1]] は [CODE(JS)@en[document.all]]
を含んでいませんでした。名前によって[[要素]]にアクセスする機能は、
[CODE(DOMm)@en[getElementByName]] と [CODE(DOMm)@en[getElementById]]
という ([[Java]] の洗礼を受けたのか) 異様に長い名前の[[メソッド]]になりました。

** 00年代

[52] [CODE(JS)@en[document.all]] は [[IE]] しか実装しませんでしたが、
短く使いやすかったので、少なくない [[Webページ]]がこれを使っていました。

[53] [[W3C]] はずっとこの現実を無視していましたが、
[[Webブラウザー]]は現実の [[Webサイト]]との互換性の要求から、
非標準でありながらも [CODE(JS)@en[document.all]] を実装せざるを得なくなりました。

[54] [[Firefox]] は[[標準モード]]ではこれを実装しないことで最後まで抵抗を続けましたが、
[[奇癖モード]]では実装せざるを得ませんでした。

[55] 一方で、[[IE]] のみが実装していた時代に、 [CODE(JS)@en[document.all]]
の有無で [[IE]] とそれ以外の[[Webブラウザー]]を分岐する悪習が広まっていました。
[CODE(JS)@en[document.all]] を実装しなければならないが、
[CODE(JS)@en[if (document.all) { ... }]] を実行してはならない、
という難題でありましたが、 [CODE(JS)@en[document.all]] [[オブジェクト]]は[[比較]]時に[[偽]]と[[評価]]される、
との特例で解決されることとなりました。

;; [56] このような動作は本来 [[JavaScript]] では認められておらず、
[CODE(JS)@en[document.all]] の他はかつて [CODE(JS)@en[styleFloat]]
[[メソッド]]で行われたくらいです。

[FIG(quote)[
[FIGCAPTION[
[1] [CITE[DOMNodeInserted と DOMNodeRemoved に似た仕組みを IE でも使えるようにして、セレクタの実行結果をキャッシュする - uupaaの開発日記]] ([TIME[2008-12-27 13:51:49 +09:00]] 版) <http://d.hatena.ne.jp/uupaa/20081127/1227726901>
]FIGCAPTION]

>
-DOMNodeInserted, DOMNodeRemoved
-- document.all.length でノード数を調べることで検出します。事前に作成されているコレクションを参照するため、かなり高速です。
-- このやり方では、挿入, 削除されたタイミングを動的に知ることはできません。
-- Firefoxの標準準拠モード以外なら、ほぼ全てのモダンブラウザで使えます。
]FIG]

[2] [[DSiブラウザ]]で [CODE(JS)@en[[[document.all]]]] は[[真]]になります・・・。

** HTML5

[50] 結局ほとんどすべての [[Webブラウザー]]が [CODE(JS)@en[document.all]]
を実装したことで、 [[HTML5]] も「廃止機能」 ([[Webブラウザー]]は実装しなければならないが、
[[著者]]が使うべきではない機能) として [CODE(JS)@en[document.all]]
を規定することになりました。

[3] [CITE[IRC logs: freenode / #whatwg / 20101115]]
( ([TIME[2010-11-20 21:48:00 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20101115#l-625>

[4] [CITE@en[Web Applications 1.0 r6900     Update HTMLAllCollection.item(DOMString) to act like namedItem.]]
( ([TIME[2012-01-18 08:02:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6899&to=6900>

[5] [CITE@en[RE: Make Microsoft follow the spec.]]
( ([[Chris Wilson]] 著, [TIME[2001-03-06 01:49:38 +09:00]] 版))
<http://lists.w3.org/Archives/Public/www-html/2001Mar/0026.html>

[6] [CITE@en[Web Applications 1.0 r7624     Clarify the document.all black magic.]]
( ([TIME[2012-12-31 13:57:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=7623&to=7624>

[7] [CITE@en[Web Applications 1.0 r7798     Fix document.all since DOM changed out from under us... also, ack for previous checkin]]
( ([TIME[2013-04-10 06:48:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=7797&to=7798>

[8] [CITE@en[Web Applications 1.0 r8469     Remove some parts of document.all that data shows have virtually no usage.]]
( ([TIME[2014-02-07 04:35:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8468&to=8469>

[9] [CITE@en[Re: twitter, document.all]]
( ([[Ms2ger]] 著, [TIME[2014-02-13 19:42:45 +09:00]] 版))
<http://lists.w3.org/Archives/Public/www-archive/2014Feb/0012.html>

[10] [CITE@en[Web Applications 1.0 r8502     Restore document.all() legacycaller, for compat]]
( ([TIME[2014-02-22 07:12:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8501&to=8502>

[11] [CITE@en[Web Applications 1.0 r8469     Remove some parts of document.all that data shows have virtually no usage.]]
( ([TIME[2014-02-07 04:35:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8468&to=8469>

[12] [CITE@en[Web Applications 1.0 r8010     Make the empty string no longer be a possible index for most objects that can be indexed by name.]]
( ([TIME[2013-07-03 06:45:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8009&to=8010>

[39] [CITE@en[Web Applications 1.0 r8501     Update the list of elements that support name='[SPAN[']] attributes for the purposes of document.all (mostly using the IE/Firefox lists, which are nearly identical, and a superset of Safari/Chrome)]]
([TIME[2014-02-22 07:09:00 +09:00]] 版)
<http://html5.org/tools/web-apps-tracker?from=8500&to=8501>

[41] [CITE@en[HTML Standard Tracker]]
( ([TIME[2014-05-22 02:46:29 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8644&to=8645>

[42] [CITE[Intent to Deprecate and Remove: document.all. - Google グループ]]
([TIME[2015-01-30 17:52:41 +09:00]] 版)
<https://groups.google.com/a/chromium.org/forum/#!topic/blink-dev/urMtTTPpUro>

[43] [CITE@ja[ブラウザ JavaScript]]
([TIME[2015-03-14 20:55:49 +09:00]] 版)
<http://www.opera.com/docs/browserjs/>

[44] [CITE@en[Fix #210: give HTMLAllCollection its own class · whatwg/html@4bade08]] ([TIME[2015-10-07 20:29:09 +09:00]] 版) <https://github.com/whatwg/html/commit/4bade08fff14d95011e2709cb2ba47e859c0a690>

[46] [CITE@en[Update ECMAScript and IDL integration · whatwg/html@550c57f]]
([TIME[2015-12-03 15:21:05 +09:00]] 版)
<https://github.com/whatwg/html/commit/550c57f186dd73784a8e4660440db2f642e37c0e>

[47] [CITE@en[Revert "Update ECMAScript and IDL integration" · whatwg/html@3a23548]]
([TIME[2015-12-03 15:27:35 +09:00]] 版)
<https://github.com/whatwg/html/commit/3a235480f1979fcddc65e07fe5a3be7bed428d17>

[48] [CITE@en[Fix #775: update HTMLAllCollection to match reality better · whatwg/html@24b8c4f]]
([TIME[2016-03-10 16:35:50 +09:00]] 版)
<https://github.com/whatwg/html/commit/24b8c4f7fcd89596eaf5335d813a559bddbb65cd>