Método getElementsByTagName() do XML DOM

Manual de referência do objeto Document

Definição e uso

O método getElementsByTagName() pode retornar uma lista de nós de elementos com o nome especificado.

Sintaxe:

getElementsByTagName(name)
Parâmetros Descrição
name valor de string, que especifica o nome do rótulo a ser pesquisado. O valor "*" coincide com todos os rótulos.

Retorno

array de leitura de nós Element com a marca especificada no documento (teoricamente, é Objeto NodeList)。A ordem dos nós de elementos retornados é a mesma que a do documento-fonte.

Descrição

Este método retornará um Objeto NodeList(tratável como um array apenas leitura), esse objeto armazena todos os nós Element que têm o nome de rótulo especificado no documento, e a ordem deles é a mesma que a do documento-fonte.Objeto NodeListé “ativa”, ou seja, se elementos com o nome de rótulo especificado forem adicionados ou removidos do documento, seu conteúdo será atualizado automaticamente de acordo com a necessidade.

Observe que a interface Element define um método com o mesmo nome, que apenas pesquisa a subárvore do documento. Além disso, a interface HTMLDocument define Método getElementsByName()procurar elementos com base no valor da propriedade name (em vez do nome do rótulo).

Exemplo

Pode usar o seguinte código para procurar e percorrer todos os elementos <h1> do documento HTML:

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

Exemplo

Em todos os exemplos, usaremos o arquivo XML books.xmle as funções JavaScript loadXMLDoc().

O seguinte fragmento de código pode exibir os valores de todos os elementos <title> do "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 />")
  }

Saída:

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Manual de referência do objeto Document