mozilla
Your Search Results

    HTMLCollection

    HTMLCollection は要素群(document 内の順序)の一般的な集合(配列)を表現したインターフェイスで,リストから選択するためのメソッドとプロパティを提供します.

    Note: This interface is called HTMLCollection for historical reasons (before DOM4, collections implementing this interface could only have HTML elements as their items).

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

    プロパティ

    HTMLCollection.length 読取専用
    collection内のアイテム数

    メソッド

    HTMLCollection.item(index)
    リスト内の指定されたindex(先頭はゼロ)位置にある特定のノードを返します.indexが範囲外ならnullを返します.
    HTMLCollection.namedItem(name)
    Returns the specific node whose ID or, as a fallback, name matches the string specified by name. Matching by name is only done as a last resort, only in HTML, and only if the referenced element supports the name attribute. Returns null if no node exists by the given name.

    JavaScriptでの使用法

    HTMLCollectionsにアクセスするJavaScriptプログラム内で,所与のHTMLCollectionのアイテムを取得するためにitem()メソッドまたはnamedItem()を直接呼び出す代わりに角括弧構文を使えます.角括弧内の数値はitem()メソッドと同様に働き, 文字列値はnamedItem()と同様に機能します.

    例えば,ドキュメント内に1つの<form>要素があるものと仮定して下さい.そのid"myForm"です:

    var elem1, elem2;
    
    // document.forms is an HTMLCollection
    
    elem1 = document.forms[0];
    elem2 = document.forms.item(0);
    
    alert(elem1 === elem2); // shows: "true"
    
    elem1 = document.forms["myForm"];
    elem2 = document.forms.namedItem("myForm");
    
    alert(elem1 === elem2); // shows: "true"

    ブラウザ互換性

    インデックス(またはnamedItemの引数)として用いられた文字列にマッチする1つ以上のエレメントがある時,ブラウザごとに異なる挙動を示します.Firefox 8 behaves as specified in DOM 2 and DOM4, returning the first matching element. WebKit browsers and Internet Explorer in this case return another HTMLCollection and Opera returns a NodeList of all matching elements.

    仕様

    See also

    ドキュメントのタグと貢献者

    Contributors to this page: acid
    最終更新者: acid,