XML DOM getElementsByTagName() 方法

Referenzhandbuch für Document Objekt

定义和用法

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];
}

Beispiel

In allen Beispielen verwenden wir XML-Dateien books.xml, sowie JavaScript-Funktionen loadXMLDoc().

Der folgende Codeabschnitt zeigt die Werte aller <title>-Elemente in "books.xml":

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 />")
  }

Ausgabe:

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Referenzhandbuch für Document Objekt