HTML DOM getElementsByName() Method

<Document Object

Plus "Try it Yourself" - "Try it Yourself" exemples ci - dessous.

Définition et utilisation

Le getElementsByName() méthode retourne une collection de tous les éléments du document avec le nom spécifié (the value of the name attribute) , comme un objet NodeList.

L'objet NodeList représente une collection de noeuds. Les nœuds sont accessibles par des numéros d'index. L'indice commence à 0.

Astuce: Vous pouvez utiliser la longueur propriété de l'objet NodeList pour déterminer le nombre d'éléments avec le nom spécifié, vous pouvez boucle à travers tous les éléments et extraire les informations que vous voulez.

Remarque: En HTML5, le "name" attribut est et a été remplacé par le "id" attribut pour de nombreux éléments. Utilisez le document. getElementById() procédé dans lequel il est approprié. Regardez aussi la getElementsByClassName() et getElementsByTagName() méthodes.

Support du navigateur

Syntaxe

document.getElementsByName( Les valeurs des paramètres

Paramètre	Type	La description
name	String	Champs obligatoires. Le name valeur d'attribut de l'élément que vous souhaitez accéder / manipuler

Détails techniques

DOM Version:	Niveau de base 1 Document Object
Valeur de retour:	Un objet NodeList, ce qui représente un ensemble d'éléments ayant le nom spécifié. Les éléments de la collection retournés sont classés comme ils apparaissent dans le code source.

---

autres exemples

Exemple

Découvrez combien d'éléments il y a dans le document qui ont un attribut name avec la valeur "animal" ( en utilisant la propriété de longueur de l'objet NodeList):

var x = document.getElementsByName("animal").length;

Essayez vous - même »

Exemple

Vérifiez tous les <input> éléments de type = « checkbox » dans le document qui ont un attribut name avec la valeur "animal" :

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

Essayez vous - même »

---

<Document Object