Método getElementsByTagName() do XML DOM

Definição e uso

O método getElementsByTagName() retorna um NodeList de todos os elementos que têm o nome especificado.

Sintaxe:

getElementsByTagName(name)
Parâmetros Descrição
name Valor de string, que define o nome de etiqueta a ser pesquisado. O valor "*" coincide com todos os nós.

Descrição

Este método percorre os descendentes dos elementos especificados, retornando um array de Elementos (na verdade um objeto NodeList), que representa todos os elementos do documento que têm o nome de etiqueta especificado. A ordem dos elementos no array é a mesma que a ordem em que eles aparecem no código-fonte do documento.

Atenção, a interface Document também define o método getElementsByTagName(), que é semelhante a este, mas percorre todo o documento, em vez de percorrer os descendentes de um elemento.

Exemplo

Em todos os exemplos, usaremos o arquivo XML books.xml, e a função JavaScript loadXMLDoc().

O seguinte trecho de código mostra todos os valores dos elementos <title> em "books.xml":

xmlDoc=loadXMLDoc("books.xml");
x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue);
document.write("<br />");
}

A saída do código acima é:

Italiano cotidiano
Harry Potter
XQuery Kick Start
Learning XML