XML DOM getElementsByTagName() -menetelmä

Document-objektin referenssikäsikirja

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

Document-objektin referenssikäsikirja