Méthode getElementsByName() du Document HTML DOM

Définition et utilisation

getElementsByName() La méthode renvoie une collection d'éléments possédant un nom spécifique.

getElementsByName() La méthode renvoie en temps réel NodeList.

NodeList

NodeList C'est une collection de nœuds similaires à un tableau (liste).

Les nœuds de la liste peuvent être accédés via des indices. L'indice commence à 0.

length Le nombre de nœuds dans la liste renvoyée par les propriétés.

Veuillez également consulter :

Méthode getElementById()

Méthode getElementsByTagName()

Méthode getElementsByClassName()

Méthode querySelector()

Méthode querySelectorAll()

Manuel de NodeList

Exemple

Exemple 1

Obtenez tous les éléments de nom="fname" :

let elements = document.getElementsByName("fname");

Essayez-le vous-même

Exemple 2

Retourne le nombre d'éléments de nom="animal" :

let num = document.getElementsByName("animal").length;

Essayez-le vous-même

Exemple 3

Vérifiez tous les éléments <input> de type="checkbox" et de nom "animal" :

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

Essayez-le vous-même

Syntaxe

document.getElementsByName(name)

Paramètre

Paramètre Description
name Obligatoire. La valeur de l'attribut name de l'élément.

Valeur de retour

Type Description
Objet

Objet NodeList.

Collection d'éléments ayant un nom spécifique.

Les éléments sont triés selon leur ordre d'apparition dans le document.

Support du navigateur

document.getElementsByName() C'est une fonctionnalité de DOM Level 1 (1998).

Tous les navigateurs le supportent :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support 9-11 Support Support Support Support