element.getElementsByTagName

  • Raccourci de la révision : DOM/element.getElementsByTagName
  • Titre de la révision : element.getElementsByTagName
  • ID de la révision : 49693
  • Créé :
  • Créateur : tregagnon
  • Version actuelle ? Non
  • Commentaire 89 words added

Contenu de la révision

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

Il est recommandé d'utiliser {{ 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

Compatibilité des navigateurs

{{ CompatibilityTable() }}

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

 

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

Source de la révision

<p>{{ 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" title="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><em>éléments</em> = <em>element</em>.getElementsByTagName(<em>balise</em>)</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 {{ Bug("206053") }} pour les détails.)</p> <p>Il est recommandé d'utiliser {{ 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" title="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>
<h2 name="Browser_Compatibility">Compatibilité des navigateurs</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop"> <table class="compat-table"> <tbody> <tr> <th>Fonction</th> <th>Chrome</th> <th>Firefox (Gecko)</th> <th>Internet Explorer</th> <th>Opera</th> <th>Safari (WebKit)</th> </tr> <tr> <td>Support de base</td> <td>1.0</td> <td>{{ CompatVersionUnknown() }}</td> <td>5.5</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> </tr> <tr> <td>getElementsByTagName("*")</td> <td>1.0</td> <td>{{ CompatVersionUnknown() }}</td> <td>6.0</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> </tr> </tbody> </table>
</div>
<div id="compat-mobile"> <table class="compat-table"> <tbody> <tr> <th>Feature</th> <th>Android</th> <th>Firefox Mobile (Gecko)</th> <th>IE Phone</th> <th>Opera Mobile</th> <th>Safari Mobile</th> </tr> <tr> <td>Support de base</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> <td>{{ CompatVersionUnknown() }}</td> </tr> </tbody> </table>
</div>
<p> </p>

<p>{{ languages( { "en": "en/DOM/element.getElementsByTagName", "es": "es/DOM/element.getElementsByTagName", "ja": "ja/DOM/element.getElementsByTagName", "pl": "pl/DOM/element.getElementsByTagName" } ) }}</p>
Revenir à cette révision