Méthode getElementsByTagName() du HTML DOM

Définition et utilisation

La méthode getElementsByTagName() peut retourner un ensemble d'objets avec un nom de balise spécifié.

Syntaxe

document.getElementsByTagName(tagname)

Explication

L'ordre des éléments retournés par la méthode getElementsByTagName() est l'ordre dans lequel ils figurent dans le document.

Si la chaîne spéciale "*" est passée à la méthode getElementsByTagName(), elle retournera une liste de tous les éléments du document, triés dans l'ordre dans lequel ils figurent dans le document.

Avis et commentaires

Remarque :La chaîne passée à la méthode getElementsByTagName() peut être insensible à la casse.

Exemple

Exemple 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="Combien d'éléments d'entrée?" />
</body>
</html>

Exemple 2

Vous pouvez obtenir une liste d'éléments HTML de n'importe quel type en utilisant la méthode getElementsByTagName(). Par exemple, le code suivant peut obtenir toutes les tables du document :

var tables = document.getElementsByTagName("table");
alert ("Ce document contient " + tables.length + " tables");

Exemple 3

Si vous connaissez très bien la structure du document, vous pouvez également utiliser la méthode getElementsByTagName() pour obtenir un élément spécifique du document. Par exemple, le code suivant peut obtenir le quatrième paragraphe du document :

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

Cependant, nous pensons toujours que si vous devez manipuler un élément spécifique, utiliser la méthode getElementById() est plus efficace.