element.getElementsByTagName

Résumé

Retourne une liste des éléments portant le nom de balise donné. La recherche porte sur le sous-arbre de l'élément spécifié, à l'exception de cet élément lui-même. La liste retournée est live, c'est à dire qu'elle se met à jour automatiquement à chaque changement de l'arbre DOM. Par conséquence, il n'est pas nécessaire d'appeller plusieurs fois element.getElementsByTagName avec le même élément et le même paramètre.

Syntaxe

liste = element.getElementsByTagName(balise)

• liste 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.

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 
    }
}

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é.

Spécification

• Spécification DOM Level 2 Core : getElementsByTagName
• Traduction en français (non normative) : getElementsByTagName

Compatibilité des navigateurs