XML DOM getElementsByTagName() methode

Definitie en gebruik

De getElementsByTagName() methode retourneert een NodeList van alle elementen met de opgegeven naam.

Syntaxis:

getElementsByTagName(name)
Parameters Beschrijving
name Een tekenreekswaarde die de te zoeken tagnaam specifies. De waarde "*" past op alle knooppunten.

Uitleg

Deze methode loopt door de nakomelingen van het opgegeven element en retourneert een array van Element-knooppunten (dat eigenlijk een NodeList-object is), die alle documentelementen met de opgegeven tagnaam vertegenwoordigt. De volgorde van de elementen in de retournerende array is dezelfde als hun volgorde in de broncode van het document.

Note that the Document interface also defines the getElementsByTagName() method, which is similar to this method, but it traverses the entire document instead of traversing the descendants of an element.

Instance

In all examples, we will use XML files books.xml, and JavaScript functions loadXMLDoc().

The following code snippet displays the values of all <title> elements 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 />");
}

The output of the above code is:

Everyday Italian
Harry Potter
XQuery Kick Start
Learning XML