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.