Document : méthode 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.
La méthode getElementsByName() de l'interface Document retourne une collection NodeList d'éléments ayant un attribut name donné dans le document.
Syntaxe
getElementsByName(name)
Paramètres
name-
La valeur de l'attribut
namedes éléments que nous recherchons.
Valeur de retour
Une collection NodeList dynamique, ce qui signifie qu'elle se met automatiquement à jour lorsque de nouveaux éléments avec le même name sont ajoutés ou supprimés du document.
Exemples
<!doctype html>
<html lang="fr">
<head>
<title>Exemple : utiliser document.getElementsByName</title>
</head>
<body>
<input type="hidden" name="up" />
<input type="hidden" name="down" />
</body>
</html>
const upNames = document.getElementsByName("up");
console.log(upNames[0].tagName); // affiche "INPUT"
Notes
L'attribut name ne peut être appliqué que dans les documents (X)HTML.
La collection NodeList retournée contient tous les éléments ayant le nom (name) donné, tels que <meta>, <object>, et même les éléments HTML qui ne supportent pas du tout l'attribut name.
Spécifications
| Specification |
|---|
| HTML # dom-document-getelementsbyname-dev |
Compatibilité des navigateurs
Voir aussi
- La méthode
document.getElementById()pour retourner une référence à un élément par son ID - La méthode
document.getElementsByTagName()pour retourner les références sur les éléments avec le même nom de balise - La méthode
document.querySelector()pour des sélecteurs par des requêtes comme"div.maclasse"