Interface HTMLCollection

継承元:

(無し)

プロパティ:

length

メソッド:

item, namedItem

HTMLCollection はノードのリストである。個々のノードには、順序のインデックス、或いはノードの name 属性か id 属性のどちらかでアクセスできる。

Note: HTML DOM のコレクションは 活きて いると考えられ、元の文書に変更があれば自動的に更新される。

プロパティ:

`htmlcollectionObject`.`length`

unsigned long型, 読取専用

このプロパティは、リストの長さもしくは サイズ を特定する。

メソッド:

`htmlcollectionObject`.`item`( `index` )

このメソッドは、順序のインデックスで指定されるノードを取得する。ノードにはツリー順(深さ優先の探索順)に番号が振られる。

引数:

index / unsigned long: 取得するノードのインデックス。インデックスは 0 から数える。

戻り値:

Node 型。成功時は該当する位置の Node 。インデックスが範囲外である場合は null 。

`htmlcollectionObject`.`namedItem`( `name` )

このメソッドは名前で Node を取得する。 [HTML 4.01] 文書では、まず id 属性のマッチングで Node の検索を行う。マッチするものが見つからなければ、次に name 属性のマッチングで Node の検索を行うが、 name 属性を許可している要素についてのみ検索が行われる。 [XHTML 1.0] 文書では, このメソッドは id 属性のマッチングで Node の検索を行うだけである。このメソッドは HTML 文書では文字ケースを区別せず、 XHTML 文書では文字ケースを区別する。

引数:

name / DOMString: 取得する Node の名前。

戻り値:

Node 型。指定された文字列に該当する値の name 属性または id 属性を持つ Node 。失敗時 (例えば, その名前のノードが存在しないなど) は null 。

IDL 定義:

interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); };