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