Método getElementsByTagName() do HTML DOM

Definição e uso

O método getElementsByTagName() pode retornar uma coleção de objetos com o nome de tag especificado.

Sintaxe

document.getElementsByTagName(tagname)

Explicação

A ordem dos elementos retornados pelo método getElementsByTagName() é a ordem em que eles aparecem no documento.

Se a string especial "*" for passada para o método getElementsByTagName(), ela retornará a lista de todos os elementos do documento, na ordem em que eles aparecem no documento.

Avisos e notas

Nota:A string passada para o método getElementsByTagName() pode não diferenciar maiúsculas e minúsculas.

Exemplo

Exemplo 1

<html>
<head>
<script type="text/javascript">
function getElements()
  {
  var x=document.getElementsByTagName("input");
  alert(x.length);
  }
</script>
</head>
<body>
<input name="myInput" type="text" size="20" /><br />
<input name="myInput" type="text" size="20" /><br />
<input name="myInput" type="text" size="20" /><br />
<br />
<input type="button" onclick="getElements()"
value="Quantos elementos de entrada?" />
</body>
</html>

Exemplo 2

Você pode usar o método getElementsByTagName() para obter uma lista de qualquer tipo de elemento HTML. Por exemplo, o código a seguir pode obter todas as tabelas do documento:

var tables = document.getElementsByTagName("table");
alert ("Este documento contém " + tables.length + " tabelas");

Exemplo 3

Se você tiver um conhecimento profundo da estrutura do documento, também pode usar o método getElementsByTagName() para obter um elemento específico do documento. Por exemplo, o código a seguir pode obter o quarto parágrafo do documento:

var myParagragh = document.getElementsByTagName("p")[3];

No entanto, ainda acreditamos que, se você precisar operar um elemento específico, usar o método getElementById() será mais eficaz.