Méthode getElementsByTagName() du XML DOM
Définition et utilisation
La méthode getElementsByTagName() retourne une liste de nœuds 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 balisages. |
Valeur de retour
Tableau lecture seul des éléments Element du document ayant la marque spécifiée (techniquement, c'est Objet NodeList）。L'ordre des éléments de retour est le même que celui de leur apparition dans le document source.
Description
Cette méthode retourne un Objet NodeList(qui peut être traité comme un tableau lecture seule), cet objet contient tous les nœuds Element du document ayant le nom de balise spécifié, et leur ordre est celui de leur apparition dans le document source.Objet NodeListC'est un objet 'vivant', c'est-à-dire que si des éléments portant le nom de balise spécifié sont ajoutés ou supprimés dans le document, son contenu est automatiquement mis à jour.
Attention, l'interface Element définit une méthode portant le même nom, qui ne recherche que le sous-arbre du document. De plus, l'interface HTMLDocument définit Méthode getElementsByName()Recherche des éléments basée sur la valeur de l'attribut name (plutôt que sur le nom du tag).
Exemple
Il est possible de rechercher et itérer tous les éléments <h1> du document HTML à l'aide du code suivant :
var headings = document.getElementsByTagName("h1");
for (var i = 0; i < headings.length; i++) {
var h = headings[i];
}
Exemple
Dans tous les exemples, nous utiliserons le fichier XML books.xmlainsi que les fonctions JavaScript loadXMLDoc().
Le fragment de code suivant peut afficher toutes les valeurs des éléments <title> dans "books.xml" :
xmlDoc=loadXMLDoc("/example/xdom/books.xml");
var x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue)
document.write("<br />")
}
Sortie :
Harry Potter Everyday Italian XQuery Kick Start Apprendre XML
