XML DOM getElementsByTagName() metode
Definition og brug
getElementsByTagName() metoden returnerer en NodeList af alle elementer med det angivne navn.
Syntaks:
getElementsByTagName(name)
| Parameter | Beskrivelse |
|---|---|
| name | Strengværdi, der angiver det etiketnavn, der skal søges efter. Værdien "*" matcher alle noder. |
Beskrivelse
Denne metode gennemgår efterkommere af angivne elementer og returnerer en Array af Element-noder (som faktisk er en NodeList-objekt), der repræsenterer alle dokumentelementer med den angivne etiketnavn. Rækkefølgen af elementer i den returnerede array er den samme som deres optræden i dokumentkildeskriptet.
Bemærk, at Document-grænsefladen også definerer getElementsByTagName() metoden, som er lignende til denne metode, men som gennemgår hele dokumentet, i stedet for at gennemgå efterkommere af et element.
Eksempel
I alle eksempler vil vi bruge XML-filen books.xml, og JavaScript funktionen loadXMLDoc().
Følgende kodefragment viser værdierne for alle <title> elementer i "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 />");
}
Udskriften af følgende kode:
Everyday Italian Harry Potter XQuery Kick Start Learning XML
