XML DOM getElementsByTagName() 方法
定義和用法
getElementsByTagName() 方法可返回帶有指定名稱的所有元素的一個節(jié)點(diǎn)列表。
語法:
getElementsByTagName(name)
參數(shù) | 描述 |
---|---|
name | 字符串值,規(guī)定需檢索的標(biāo)簽名。值 "*" 匹配所有的標(biāo)簽。 |
返回值
文檔樹中具有指定標(biāo)記的 Element 節(jié)點(diǎn)的只讀數(shù)組(從技術(shù)上講,是 NodeList 對象)。返回的元素節(jié)點(diǎn)的順序就是它們在源文檔中出現(xiàn)的順序。
說明
該方法將返回一個 NodeList 對象(可以作為只讀數(shù)組處理),該對象存放文檔中具有指定標(biāo)簽名的所有 Element 節(jié)點(diǎn),它們存放的順序就是在源文檔中出現(xiàn)的順序。NodeList 對象是“活”的,即如果在文檔中添加或刪除了指定標(biāo)簽名的元素,它的內(nèi)容會自動進(jìn)行必要的更新。
注意,Element 接口定義了一個同名的方法,該方法只檢索文檔的子樹。另外,HTMLDocument 接口定義了 getElementsByName() 方法,基于 name 屬性的值(而不是標(biāo)簽名)檢索元素。
例子
可以用下列代碼檢索并遍歷 HTML 文檔中的所有 <h1> 標(biāo)記:
var headings = document.getElementsByTagName
("h1");
for (var i = 0; i < headings.length; i++) {
var h = headings[i];
}
實(shí)例
在所有的例子中,我們將使用 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