Méthode getElementsByTagName() du XML DOM
Définition et utilisation
La méthode getElementsByTagName() retourne un NodeList contenant tous les éléments ayant le nom spécifié.
Syntaxe :
getElementsByTagName(name)
Paramètres | Description |
---|---|
name | Valeur de chaîne, spécifiant le nom de balise à rechercher. La valeur "*" correspond à tous les nœuds. |
Explication
Cette méthode parcourt les descendants des éléments spécifiés, et retourne un tableau d'éléments Element (en réalité un objet NodeList), représentant tous les éléments de document ayant le nom de balise spécifié. L'ordre des éléments dans le tableau est le même que leur ordre d'apparition dans le code source du document.
Notez que l'interface Document définit également la méthode getElementsByTagName(), qui est similaire à cette méthode, mais parcourt tout le document au lieu de parcourir les descendants d'un élément.
Exemple
Dans tous les exemples, nous utiliserons le fichier XML books.xml, et les fonctions JavaScript loadXMLDoc().
Le code suivant montre toutes les valeurs des éléments <title> dans "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 />");
}
La sortie du code ci-dessus :
Everyday Italian Harry Potter XQuery Kick Start Learning XML