XML DOM getElementsByTagName()メソッド

Document オブジェクトリファレンスマニュアル

定義と使用方法

getElementsByTagName()メソッドは、指定された名前を持つすべての要素のノードリストを返します。

構文:

getElementsByTagName(name)
パラメータ 説明
name 文字列値、検索する必要があるタグ名を指定します。値「*」はすべてのタグに一致します。

返値

指定されたタグのElementノードを持つ読み取り専用の配列(技術的には、 NodeListオブジェクト)。返される要素ノードの順序は、ソースドキュメント内で現れる順序と一致します。

説明

このメソッドは以下を返します NodeListオブジェクト(読み取り専用の配列として処理できます)、このオブジェクトは指定されたタグ名を持つすべてのElementノードを保存しており、その順序はソースドキュメント内で現れる順序と一致します。NodeListオブジェクト「生」データ、すなわち指定されたタグ名の要素がドキュメントに追加または削除された場合、内容が自動的に必要な更新を行うためのものです。

注意、Elementインターフェースは同じ名前のメソッドを定義しており、それはドキュメントのサブツリーのみを検索します。また、HTMLDocumentインターフェースは以下を定義しています getElementsByName()メソッド、name属性の値に基づいて要素を検索します(タグ名ではなく)。

HTML文書ドキュメント内のすべての<h1>タグを検索および巡回するための以下のコードを使用できます:

var headings = document.getElementsByTagName("h1")
for (var i = 0; i < headings.length; i++)  {
  var h = headings[i];
}

インスタンス

すべての例では、XML ファイルを使用します books.xml、および JavaScript ファンクション loadXMLDoc()

以下のコードスニペットは "books.xml" 中のすべての <title> 要素の値を表示します:

xmlDoc=loadXMLDoc("/example/xdom/books.xml");
var x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
  {
  document.write(x[i].childNodes[0].nodeValue)
  document.write("<br />")
  }

出力:

ハリ・ポッター
Everyday Italian
XQuery Kick Start
Learning XML

Document オブジェクトリファレンスマニュアル