element.getElementsByTagName

  • Raccourci de la révision : DOM/element.getElementsByTagName
  • Titre de la révision : element.getElementsByTagName
  • ID de la révision : 49691
  • Créé :
  • Créateur : Mgjbot
  • Version actuelle ? Non
  • Commentaire robot Ajoute: [[es:DOM:element.getElementsByTagName]] <<langbot>>

Contenu de la révision

{{template.DomRef()}}

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.

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 {{template.Bug(206053)}} pour les détails.)

Il est recommandé d'utiliser {{template.Domxref("element.getElementsByTagNameNS")}} lorsque vous travaillez avec des documents comprenant plusieurs espaces de noms.

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

{{ wiki.languages( { "en": "en/DOM/element.getElementsByTagName", "es": "es/DOM/element.getElementsByTagName", "pl": "pl/DOM/element.getElementsByTagName" } ) }}

Source de la révision

<p>
{{template.DomRef()}}
</p>
<h3 name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p>Renvoie une liste des éléments portant le <a href="fr/DOM/element.tagName">nom de balise</a> donné. La recherche porte sur le sous-arbre descendant de l'élément spécifié, à l'exception de cet élément lui-même.
</p>
<h3 name="Syntaxe"> Syntaxe </h3>
<p><i>éléments</i> = <i>element</i>.getElementsByTagName(<i>balise</i>) 
</p>
<ul><li> <code>éléments</code> est une liste de nœuds <code>NodeList</code> contenant les éléments trouvés, dans l'ordre dans lequel ils apparaissent dans le sous-arbre.
</li><li> <code>element</code> 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.
</li><li> <code>balise</code> est le nom qualifié à rechercher. La chaîne spéciale <code>"*"</code> représente tous les éléments possibles.
</li></ul>
<div class="note">
<p>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 {{template.Bug(206053)}} pour les détails.)
</p><p>Il est recommandé d'utiliser {{template.Domxref("element.getElementsByTagNameNS")}} lorsque vous travaillez avec des documents comprenant plusieurs espaces de noms.
</p>
</div>
<h3 name="Exemple"> Exemple </h3>
<pre>// 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 &lt; cells.length; i++) { 
    status = cells[i].getAttribute("status"); 
    if ( status == "open") { 
        // récupère les données 
    }
}
</pre>
<h3 name="Notes"> Notes </h3>
<p><code>element.getElementsByTagName</code> est similaire à <a href="fr/DOM/document.getElementsByTagName">document.getElementsByTagName</a>, la seule différence étant que la recherche est ici réduite aux éléments descendants de l'élément spécifié. 
</p>
<h3 name="Sp.C3.A9cification"> Spécification </h3>
<ul><li> Spécification DOM Level 2 Core : <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1938918D">getElementsByTagName</a>
</li><li> Traduction en français (non normative) : <a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-1938918D">getElementsByTagName</a>
</li></ul>
<div class="noinclude">
</div>
{{ wiki.languages( { "en": "en/DOM/element.getElementsByTagName", "es": "es/DOM/element.getElementsByTagName", "pl": "pl/DOM/element.getElementsByTagName" } ) }}
Revenir à cette révision