XML DOM getElementsByTagName() Methode

Definition und Verwendung

Die Methode getElementsByTagName() gibt eine NodeList aller Elemente mit dem angegebenen Namen zurück.

Syntax:

getElementsByTagName(name)
Parameter Beschreibung
name Zeichenkette, die den zu suchenden Tagnamen angibt. Der Wert "*" entspricht allen Knoten.

Erklärung

Diese Methode durchsucht die Nachkommenknoten eines bestimmten Elements und gibt ein Array von Element-Knoten (tatsächlich ein NodeList-Objekt) zurück, das alle Dokumentelemente mit dem angegebenen Tagnamen darstellt. Die Reihenfolge der Elemente im zurückgegebenen Array entspricht ihrer Reihenfolge im Quellcode des Dokuments.

Beachtung, der Document-Interface definiert ebenfalls die Methode getElementsByTagName(), die der genannten Methode ähnlich ist, aber den gesamten Dokument durchsucht, anstatt die Nachkommenknoten eines Elements zu durchsuchen.

Beispiel

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

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

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

Die Ausgabe des folgenden Codes ist:

Everyday Italian
Harry Potter
XQuery Kick Start
Learning XML