Méthode : window.document.getElementsByName()

Retourne un tableau d'éléments HTML ayant l'attribut name qui vaut nom

Syntaxe
Array document.getElementsByName(String nom)

Attention, incompatible avec Safari

Oui

Non

Oui

Description
Retourne un tableau d'éléments HTML HTMLElement ayant nom défini dans la propriété name de la balise de l'objet.
Ne pas confondre la propriété id et la propriété name. Pour trouver un objet à partir de son id, utilisez getElementById().
Pour trouver une liste d'élément à partir de leur tag, utilisez getElementsByTagName().
Pour trouver une liste d'élément à partir de leur classe, utilisez getElementsByClassName().

Exemple 1 : Case à cocher

Code source

<form name="form_fruit">
<input type="checkbox" name="fruit" value="Fraise"> Fraise <BR>
<input type="checkbox" name="fruit" value="Banane"> Banane <BR>
<input type="checkbox" name="fruit" value="Pomme"> Pomme <BR>
</form>
<script type="text/javascript">
console.log(typeof document.getElementsByName("fruit"));
document.getElementsByName("fruit")[0].checked = true;
document.getElementsByName("fruit")[1].checked = true;
document.getElementsByName("fruit")[2].checked = true;
</script>

Résultat

Emulation de la console

Explication

Cet exemple crée 3 cases à cocher ayant le même nom fruit.
Le script qui suit la déclaration des cases recherche les objets de nom fruit avec getElementsByName et force la propriété checked à true. Les cases sont donc repérées et cochées par programmation.

Page en rapport
Introduction au DHTML

Page mise à jour le 07/08/2018

Troisième édition Tout JavaScript chez Dunod

En savoir plus
Sortie le 4 janvier 2023

Version papier 29€90
Format électronique 22€99.

Commandez en ligne

Dunod Fnac Amazon

Méthode : window.document.getElementsByName()

Retourne un tableau d'éléments HTML ayant l'attribut name qui vaut nom

Troisième édition Tout JavaScript chez Dunod

Chercher une fonction, un objet, ...