Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

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: getElementsByNametraduction en français (non normative)

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : fscholz, teoli, jsx, BenoitL
 Dernière mise à jour par : jsx,