From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/htmlcollection/index.html | 91 ++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 files/ja/web/api/htmlcollection/index.html (limited to 'files/ja/web/api/htmlcollection/index.html') diff --git a/files/ja/web/api/htmlcollection/index.html b/files/ja/web/api/htmlcollection/index.html new file mode 100644 index 0000000000..0a7d4bf6a7 --- /dev/null +++ b/files/ja/web/api/htmlcollection/index.html @@ -0,0 +1,91 @@ +--- +title: HTMLCollection +slug: Web/API/HTMLCollection +tags: + - API + - DOM + - Element Lists + - HTMLCollection + - Interface + - Reference +translation_of: Web/API/HTMLCollection +--- +

{{APIRef("DOM")}}

+ +

HTMLCollection インターフェイスは、 (文書内の順序における) 要素の一般的なコレクション ({{jsxref("Functions/arguments", "arguments")}} のような配列風のオブジェクト) を表し、リストから選択するためのメソッドとプロパティを提供します。

+ +
注: このインターフェイスは歴史的な理由で HTMLCollection と呼ばれています (現代の DOM より前は、このインターフェイスを実装するコレクションが、アイテムとして HTML 要素しか持てませんでした)。
+ +

HTML DOM 内の HTMLCollection は生きて (live) います。それらは元になった document が変更された時点で自動的に更新されます。

+ +

プロパティ

+ +
+
{{domxref("HTMLCollection.length")}} {{readonlyInline}}
+
collection 内のアイテム数を返します。
+
+ +

メソッド

+ +
+
{{domxref("HTMLCollection.item()")}}
+
リスト内の指定された index (先頭はゼロ) 位置にある特定のノードを返します。index が範囲外なら null を返します。
+
これは collection[i] のアクセスの代替手段です (こちらは i が範囲外の場合は undefined を返します)。これは主に、 JavaScript 以外の DOM 実装で有用です。
+
{{domxref("HTMLCollection.namedItem()")}}
+
name で指定した文字列に ID、または代替として name が一致するノードを返します。name とのマッチングは HTML 限定で、参照した要素が name 属性をサポートする場合に限って、最終手段として行われます。指定した名前のノードがない場合は null を返します。
+
これは collection[name] のアクセスの代替手段です (こちらは name が存在しない場合、 undefined を返します)。これは主に、 JavaScript 以外の DOM 実装で有用です。
+
+ +

JavaScript での使用法

+ +

HTMLCollection は名前やインデックスでも、自身のメンバーをプロパティとして直接公開します。HTML の ID は : や . を有効な文字として含むことができ、これらはプロパティとしてアクセスするために角括弧構文を使用しなければなりません。現在の HTMLCollections は純粋な数値の ID を認識しません。このような ID は配列へのアクセスと競合しますが、HTML5 では許容しています。

+ +

例えば、文書内に 1 つの <form> 要素があるものと仮定してください。その id は myForm です。

+ +
var elem1, elem2;
+
+// document.forms は HTMLCollection
+
+elem1 = document.forms[0];
+elem2 = document.forms.item(0);
+
+alert(elem1 === elem2); // 表示: "true"
+
+elem1 = document.forms.myForm;
+elem2 = document.forms.namedItem("myForm");
+
+alert(elem1 === elem2); // 表示: "true"
+
+elem1 = document.forms["named.item.with.periods"];
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('DOM WHATWG', '#htmlcollection', 'HTMLCollection')}}{{ Spec2('DOM WHATWG') }}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.HTMLCollection")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf