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

Syntaxe

elements = document.getElementsByName(name) 
  • elements est une collection de NodeList
  • name est la valeur de l'attribut name des éléments.

Exemple

<!DOCTYPE html>
<html lang="en">
<head>
 ...
</head>

<body>
<form name="up"><input type="text"></form>
<div name="down"><input type="text"></div>

<script>
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // retourne "FORM"
</script>
</body>
</html>

Notes

L'attribut name est uniquement applicable aux documents (X) HTML. La méthode renvoie une collection NodeList en cours qui contient tous les éléments avec une valeur donnée pour l'attribut name, tels que <meta> ou <object> ou même si le nom est placé sur des éléments qui ne supportent pas du tout un attribut name.

La méthode getElementsByName fonctionne différemment dans différents navigateurs. Dans IE <10, la méthode getElementsByName () renvoie également les éléments qui ont un attribut id avec la valeur spécifiée. Vous devriez donc faire attention à ne pas utiliser la même chaîne pour le nom et l'identifiant.

Spécifications

Spécification Statut Commentaire
HTML Living Standard
La définition de 'Document.getElementsByName()' dans cette spécification.
Standard évolutif  
Document Object Model (DOM) Level 2 HTML Specification
La définition de 'Document.getElementsByName()' dans cette spécification.
Obsolete Définition initiale

Voir aussi

 

Étiquettes et contributeurs liés au document

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