Collection d'éléments de formulaire

Définition et utilisation

elements L'ensemble renvoie l'ensemble de tous les éléments du formulaire.

Remarque :Les éléments de l'ensemble sont triés dans l'ordre de leur apparition dans le code source.

Remarque :La collection elements retourne tous les éléments à l'intérieur de l'élément <form>, et non tous les éléments <form> du document. Pour obtenir tous les éléments <form> du document, utilisez Collection document.forms.

Exemple

Exemple 1

Trouver combien d'éléments il y a dans le <form> spécifié :

var x = document.getElementById("myForm").elements.length;

Essayez-le vous-même

Le résultat de x sera :

3

Avis :Plus d'exemples sont fournis en bas de la page.

Syntaxe

formObject.elements

Propriété

Propriété Description
length

Retourne le nombre d'éléments dans l'élément <form>.

Remarque :Cette propriété est en lecture seule.

Méthode

Méthode Description
[index]

Retourne l'élément avec l'index spécifié dans <form> (commençant par 0).

Remarque :Retourne null si le numéro d'index dépasse la gamme.

item(index)

Retourne l'élément avec l'index spécifié dans <form> (commençant par 0).

Remarque :Retourne null si le numéro d'index dépasse la gamme.

namedItem(id)

Retourne l'élément avec l'id spécifié dans <form>.

Remarque :Retourne null si l'id n'existe pas.

Détails techniques

Version DOM : Document Object Model de niveau 2
Valeur de retour :

L'objet HTMLFormsControlCollection représente tous les éléments du <form>.

Les éléments de l'ensemble sont triés selon leur ordre d'apparition dans le code source.

Plus d'exemples

Exemple 2 : [index]

Obtenir la valeur du premier élément du formulaire (index 0) :

var x = document.getElementById("myForm").elements[0].value;

Essayez-le vous-même

Le résultat de x sera :

Donald

Exemple 3 : item(index)

Obtenir la valeur du premier élément du formulaire (index 0) :

var x = document.getElementById("myForm").elements.item(0).value;

Essayez-le vous-même

Le résultat de x sera :

Donald

Exemple 4 : namedItem(id)

Obtenir la valeur de l'élément name="fname" dans le formulaire :

var x = document.getElementById("myForm").elements.namedItem("fname").value;

Essayez-le vous-même

Le résultat de x sera :

Donald

Exemple 5

Parcourir tous les éléments du formulaire et afficher la valeur de chaque élément :

var x = document.getElementById("myForm");
var txt = "";
var i;
for (i = 0; i < x.length; i++) {
  txt = txt + x.elements[i].value + "<br>";
}
document.getElementById("demo").innerHTML = txt;

Essayez-le vous-même

Le résultat de x sera :

Donald
Duck
Soumettre

Support du navigateur

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Support Support Support Support Support