Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
document.getElementsByName()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2018.
Renvoie une liste des éléments portant unname donné dans le document (X)HTML.
Syntaxe
elements = document.getElementsByName(name);elementsest une collection deNodeListnameest la valeur de l'attributnamedes é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'attributname est uniquement applicable aux documents (X) HTML. La méthode renvoie une collectionNodeList 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 attributname.
La méthodegetElementsByName 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 # 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'