XML DOM getElementsByTagName()-menetelmä
Määrittely ja käyttö
getElementsByTagName()-menetelmä palauttaa NodeList-objektin, joka sisältää kaikki määritellyllä nimellä varustetut elementit.
Syntaksi:
getElementsByTagName(name)
| Parametrit | Kuvaus |
|---|---|
| name | Merkistöarvo, joka määrittää haettavan elementin nimen. Arvo "*" sopii kaikkiin solmuihin. |
Selitys
Tämä menetelmä käydään läpi määritellyn elementin jälkeläisnodut ja palauttaa Element-nodemaan, joka on todellisuudessa NodeList-objekti, joka edustaa kaikkia määritellyllä nimellä varustettuja dokumenttielementtejä. Elementtien järjestys palautetussa taulukossa on sama kuin niiden järjestys dokumentin lähdekoodissa.
Huomaa, että Document-rajapinta määrittelee myös getElementsByTagName()-menetelmän, joka on samanlaista kuin tämä menetelmä, mutta se käydään läpi koko dokumentin, ei vain jossain elementin lapsisolmuissa.
Esimerkki
Kaikissa esimerkeissä käytämme XML-tiedostoja books.xmlja JavaScript-funktiot loadXMLDoc().
Seuraava koodinpätkä näyttää "books.xml"-tiedostossa kaikkien <title>-elementtien arvot:
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 />");
}
Tämän koodin tulostus:
Everyday Italian Harry Potter XQuery Kick Start Learning XML
