mozilla
Vos résultats de recherche

    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

    Compatibilité des navigateurs

    Fonction Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Support de base 1.0 (Oui) 5.5 (Oui) (Oui)
    getElementsByTagName("*") 1.0 (Oui) 6.0 (Oui) (Oui)
    Fonction Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
    Support de base (Oui) (Oui) (Oui) (Oui) (Oui)

    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.

     

    Étiquettes et contributeurs liés au document

    Étiquettes : 
    Dernière mise à jour par : khalid32,