Skip to main content

Visit Mozilla.org

DOM:element.getElementsByTagName

Un article de MDC.

« Référence du DOM Gecko

Sommaire

[modifier] Résumé

Renvoie une liste des éléments portant le nom de balise donné. La recherche porte sur le sous-arbre descendant de l'élément spécifié, à l'exception de cet élément lui-même.

[modifier] Syntaxe

éléments = element.getElementsByTagName(balise)

  • éléments est une liste de nœuds NodeList contenant les éléments trouvés, dans l'ordre dans lequel ils apparaissent dans le sous-arbre.
  • element est l'élément depuis lequel la recherche doit commencer. Notez que seuls les descendants de cet élément feront partie des résultats, mais pas l'élément lui-même.
  • balise est le nom qualifié à rechercher. La chaîne spéciale "*" représente tous les éléments possibles.

Dans Firefox 2 (Gecko 1.8.1) et précédents, cette méthode ne fonctionnait pas correctement si l'arbre contenait des éléments avec des préfixes d'espaces de noms dans leurs noms de balises (voir bug 206053 pour les détails.)

Il est recommandé d'utiliser element.getElementsByTagNameNS lorsque vous travaillez avec des documents comprenant plusieurs espaces de noms.

[modifier] Exemple 

// vérifie l'alignement d'une série de cellules d'un tableau. 
var table = document.getElementById("tableau-previsions"); 
var cells = table.getElementsByTagName("td"); 
for (var i = 0; i < cells.length; i++) { 
    status = cells[i].getAttribute("status"); 
    if ( status == "open") { 
        // récupère les données 
    }
}

[modifier] Notes

element.getElementsByTagName est similaire à document.getElementsByTagName, la seule différence étant que la recherche est ici réduite aux éléments descendants de l'élément spécifié.

[modifier] Spécification

Récupérée de « http://developer.mozilla.org/fr/docs/DOM:element.getElementsByTagName »