document.getElementsByName

Résumé

Renvoie une liste des éléments portant un nom (attribut name) particulier dans le document (X)HTML.

Syntaxe

elements = document.getElementsByName(name) 

• elements est une liste d'éléments (NodeList).
• name est la valeur de l'attribut name des éléments à trouver.

Exemple

// renvoie certains des éléments div
//<div name="haut">200</div> 
//<div name="haut">145</div> 
//<div name="bas">146</div> 
//<div name="autre">178</div> 
divs_haut = document.getElementsByName("haut"); 
dump(divs_haut.item(0).tagName); // renvoie "div"

Notes

L'attribut name n'est valide que pour un ensemble limité d'éléments HTML, par conséquent getElementsByName() n'est applicable qu'à ces éléments.

Cette méthode n'est applicable qu'aux documents (X)HTML.

document.getElementsByName renvoie une liste d'éléments (NodeList) de tous les éléments portant une certaine valeur pour d'attribut name. Contrairement à getElementsByTagName, qui utilise le nom de la balise elle-même, cette méthode s'applique uniquement aux éléments qui ont reçu une valeur pour leur attribut name.

Spécification

DOM Level 2 HTML: getElementsByName — traduction en français (non normative)