モジュール jdk.xml.dom

パッケージ org.w3c.dom.html

インタフェースHTMLCollection

public interface HTMLCollection

HTMLCollectionはノードのリストです。 個々のノードは、順序付けされたインデックスや、ノードのname属性またはid属性でアクセスできます。 ノート: HTML DOM内のコレクションは有効であるとみなされ、基盤となるドキュメントが変更されたときに自動的に更新されます。

「Document Object Model (DOM) Level 2 Specification」も参照してください。

導入されたバージョン:

1.4、DOMレベル2

メソッドのサマリー

修飾子と型	メソッド	説明
int	getLength()	この属性は、リストの長さ(サイズ)を指定します。
Node	item(int index)	このメソッドは、順序付けされたインデックスで指定されたノードを取得します。
Node	namedItem(String name)	このメソッドは、名前を使用してNodeを取得します。

メソッドの詳細

getLength

int getLength()

この属性は、リストの長さ(サイズ)を指定します。

item

Node item(int index)

このメソッドは、順序付けされたインデックスで指定されたノードを取得します。 ノードはツリーの順序(深さ優先トラバーサルの順序)で番号が割り当てられています。

パラメータ:

index - フェッチされるノードのインデックス。 インデックスは0から始まる。

戻り値:

成功したときは、対応する位置のNode。 インデックスが範囲外の場合はnull値が返される。

namedItem

Node namedItem(String name)

このメソッドは、名前を使用してNodeを取得します。 まずid属性が一致するNodeを検索します。 該当しなかった場合はname属性が一致するNodeを検索します。ただし検索対象はname属性のある要素に限られます。

パラメータ:

name - 取得されるNodeの名前。

戻り値:

name属性値やid属性値が指定した文字列に一致するNode。 失敗した場合(指定した名前のノードが存在しない場合など)はnullを返す。