document.getElementsByName()
Renvoie une liste des éléments portant un name
donné dans le document (X)HTML.
Syntaxe
elements = document.getElementsByName(name);
elements
est une collection deNodeList
name
est la valeur de l'attributname
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
Specification |
---|
HTML Standard # dom-document-getelementsbyname-dev |
Voir aussi
document.getElementById()
pour retourner une référence à un élément par son IDdocument.getElementsByTagName()
pour renvoyer les références sur les éléments avec la balise de nom donnéedocument.querySelector()
pour des sélecteurs par des requêtes comme'div.myclass'