XML DOM getElementsByTagName() -menetelmä
Määrittely ja käyttö
getElementsByTagName() -menetelmä voi palauttaa nimikkeellä varustetut kaikkien elementtien solmulistan.
Syntaksi:
getElementsByTagName(name)
Parametrit | Kuvaus |
---|---|
name | Merkkiarvo, joka määrittää haettavan nimikkeen. Arvo "*" sopii kaikkiin nimikkeisiin. |
Palautusarvo
Dokumenttikivun määritellyllä merkinnällä varustetut Element-elementtien lukulista (teknisesti sanottuna, se on NodeList-objekti)。Palautetut elementin solmut ovat järjestyksessä, jossa ne ilmestyvät alkuperäisessä dokumentissa.
Kuvaus
Tämä menetelmä palauttaa NodeList-objekti(voidaan käsitellä vain lukuarrayna), tämä objekti sisältää kaikki dokumentissa olevat Element-elementit, niiden järjestys on sama kuin ne ilmestyvät alkuperäisessä dokumentissa.NodeList-objektiSe on 'elävä', eli jos dokumenttiin lisätään tai poistetaan määritettyä nimiketta elementtiä, sen sisältö päivitetään automaattisesti.
Huomaa, että Element-ikkuna määrittelee samannimisen menetelmän, joka hakee vain dokumentin alijärjestelmän. getElementsByName() -menetelmäEtsi elementtejä name-ominaisuuden arvon perusteella (ei nimikkeestä).
Esimerkki
Voi hakea ja käydä läpi kaikki HTML-dokumentin <h1>-merkit seuraavilla koodilla:
var headings = document.getElementsByTagName
(")h1"(")
for (var i = 0; i < headings.length; i++) {
var h = headings[i];
}
Esimerkki
Kaikissa esimerkeissä käytämme XML-tiedostoja books.xmlja JavaScript-funktiot loadXMLDoc().
Seuraava koodipala näyttää "books.xml"-tiedostossa kaikkien <title>-elementtien arvot:
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 />")
}
Tulostus:
Harry Potter Everyday Italian XQuery Kick Start Learning XML