NodeList - ノードの集合

概要

名前

NodeList

IDL

[Exposed=Window]
interface NodeList {
  getter Node? item(unsigned long index);
  readonly attribute unsigned long length;
  iterable<Node>;
};

仕様書

https://dom.spec.whatwg.org/#nodelist

チュートリアル

NodeListは、ノードの集合を取得する各メソッドの返り値として、取得できます。典型的なメソッドは、Document.getElementsByName()です。

<input name="hoge" value="SYNCER1">
<input name="hoge" value="SYNCER2">
<input name="hoge" value="SYNCER3">

// NodeListを取得
var nodes = document.getElementsByName( "hoge" ) ;

// NodeListの内容
nodes[0] ;	// <input name="hoge" value="SYNCER1">
nodes[1] ;	// <input name="hoge" value="SYNCER2">
nodes[2] ;	// <input name="hoge" value="SYNCER3">

iterable属性があり、Array.prototype.forEach()などで反復処理できます。

nodes.forEach( function ( node ) {
	console.log( node ) ;
} ) ;

コンストラクタ

コンストラクタはありません。

プロパティ

length

集合に含まれるノードの個数を返します。

メソッド

item()

インデックス番号を指定してノードを取得します。このメソッドは、ブラケット記法(例: [0])に置き換えられます。

定数

固有の定数はありません。

イベント

固有のイベントハンドラはありません。

サポート状況

クリックすると、バージョンごとの対応状況を確認できます。

関連記事

Document.getElementsByName()

getElementsByName()は、Documentのメソッドです。name属性を指定してノードを取得します。

Selection.addRange()

addRange()は、Selectionのメソッドです。Rangeを指定して選択範囲をセットします。既に選択範囲が存在する場合、無視されます。

Selection.type

typeは、Selectionのプロパティです。選択範囲の種類を文字列で返します。

Selection.focusNode

focusNodeは、Selectionのプロパティです。選択範囲の終点を含むノードを返します。