Document 對象參考手冊

定義和用法

getElementsByTagName() 方法可返回帶有指定名稱的所有元素的一個節(jié)點列表。

語法：

getElementsByTagName(name)

返回值

文檔樹中具有指定標記的 Element 節(jié)點的只讀數(shù)組（從技術上講，是 NodeList 對象）。返回的元素節(jié)點的順序就是它們在源文檔中出現(xiàn)的順序。

說明

該方法將返回一個 NodeList 對象（可以作為只讀數(shù)組處理），該對象存放文檔中具有指定標簽名的所有 Element 節(jié)點，它們存放的順序就是在源文檔中出現(xiàn)的順序。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 函數(shù) 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 />")
  }

輸出：

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Document 對象參考手冊