XML DOM getElementsByTagName() metoden

Document objekt referencemanual

Defininition og brug

getElementsByTagName() metoden kan returnere en node-liste med alle elementer med det specifikke navn.

Syntaks:

getElementsByTagName(name)
Parameter Beskrivelse
name Strengværdi, der angiver det mærke, der skal søges efter. Værdien "*" matcher alle mærker.

Returværdi

Skrivebeskyttet array af Element-knuder med den specifikke mærke i dokumentet (teknisk set er NodeList-objektet)。Returkaraktererne for elementknuderne er i samme rækkefølge som de forekommer i kilden.

Beskrivelse

Denne metode vil returnere en NodeList-objektet(kan behandles som en skrivebeskyttet array), dette objekt indeholder alle Element-noder med den specifikke tagnavn i dokumentet, og deres rækkefølge er den samme som deres forekomst i kilden.NodeList-objekteter 'levende', hvilket betyder, at hvis der tilføjes eller fjernes elementer med den specifikke tagnavn i dokumentet, vil indholdet automatisk opdateres nødvendigt.

Bemærk, at Element-grænsefladen definerer en metode med samme navn, som kun søger i dokumentets undertræer. Desuden definerer HTMLDocument-grænsefladen getElementsByName() metoden,søg efter elementer baseret på værdien af property 'name' (ikke mærkernavn).

Eksempel

Brug følgende kode til at finde og gennemgå alle <h1>-markeringer i HTML-dokumentet:

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

Eksempel

I alle eksempler vil vi bruge XML-filer books.xmlog JavaScript funktioner loadXMLDoc()

Følgende kodefragment kan vise værdierne for alle <title> elementer 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 />")
  }

Output:

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Document objekt referencemanual