XML DOM getElementsByTagName() methode

Document object reference manual

Definitie en gebruik

getElementsByTagName() methode kan een lijst van knooppunten retourneren die alle elementen met de gespecificeerde naam bevatten.

Syntaxis:

getElementsByTagName(name)
Parameters Beschrijving
name Een tekenreekswaarde die de te zoeken tagnaam specifies. De waarde "*" past op alle tags.

Retourwaarde

Alleen-lezen array van Element-knooppunten met de gespecificeerde markering in de documentboom (technisch gezien, is NodeList-object)。De volgorde van de elementknooppunten is dezelfde als hun volgorde in het brondocument.

Beschrijving

Deze methode retourneert een NodeList-object(kan als een alleen-lezen array worden behandeld), dit object bevat alle Element-knooppunten met de gespecificeerde tagnaam in het document, en hun volgorde is dezelfde als in de brondocument.NodeList-objectis 'levend', wat betekent dat als er elementen met de specifieke tagnaam worden toegevoegd of verwijderd in het document, de inhoud automatisch de benodigde updates uitvoert.

Let op, de Element-interface definieert een methode met dezelfde naam, die alleen de subboom van het document zoekt. Bovendien definieert de HTMLDocument-interface getElementsByName() methode,op basis van de waarde van het name-eigenschap (in plaats van de tagnaam) elementen te zoeken.

Voorbeeld

Uw kunt de volgende code gebruiken om alle <h1> tags in het HTML-document te zoeken en te doorlopen:

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

Instance

In all examples, we will use the XML file books.xml, and JavaScript functions loadXMLDoc().

The following code snippet can display the values of all <title> elements in "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 object reference manual