XML DOM getElementsByTagName() metod

Dokumentobjektets referenshandbok

Definition och användning

getElementsByTagName() metoden returnerar en nodlista med alla element som har det specificerade namnet.

Syntaks:

getElementsByTagName(name)
Parameter Beskrivning
name Strängvärde som specificerar det etikett som ska sökas. Värdet "*" matchar alla etiketter.

Returvärdet

En skrivskyddad array av Element-noder med specifikt markering i dokumentstrukturen (tekniskt sett är det NodeList-objekt)。Returnerade elementnodernas ordning är samma som deras ordning i källdokumentet.

Förklaring

Denna metod returnerar en NodeList-objekt(kan hanteras som en skrivskyddad array),detta objekt innehåller alla Element-noder med den specificerade etiketten i dokumentet, och deras ordning är samma som deras ordning i källdokumentet.NodeList-objektär 'levande', vilket innebär att om du lägger till eller tar bort element med en viss etikett i dokumentet, kommer dess innehåll att uppdateras automatiskt.

Observera att Element-gränssnittet definierar en metod med samma namn, som endast söker i dokumentets underträd. Dessutom definierar HTMLDocument-gränssnittet getElementsByName() metoden,söka efter element baserat på värdet av name-attributet (inte etiketten)

Exempel

Kan följande kod användas för att söka och traversera alla <h1>-taggar i HTML-dokumentet:

var headings = document.getElementsByTagName(")h1"")
for (var i = 0; i < headings.length; i++)  {
  var h = headings[i];
}

Exempel

I alla exempel kommer vi att använda XML-filer books.xmloch JavaScript-funktioner loadXMLDoc().

Följande kodsnutt kan visa alla värden för <title> elementen i "books.xml":

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 />")
  }

Uttalande:

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Dokumentobjektets referenshandbok