HTMLFieldSetElement : propriété elements
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 avril 2018.
La propriété en lecture seule elements de l'interface HTMLFieldSetElement retourne un objet HTMLCollection contenant tous les éléments de contrôle de formulaire (<button>, <fieldset>, <input>, <object>, <output>, <select> et <textarea>) qui sont descendants de ce jeu de champs.
Vous pouvez accéder à un contrôle de formulaire particulier dans la collection retournée en utilisant soit un index, soit les attributs name ou id de l'élément. Si plusieurs contrôles partagent le même nom, comme c'est courant pour un groupe de boutons radio, l'utilisation du nom partagé retourne le premier élément ayant cette valeur.
Valeur
Un objet HTMLCollection.
Exemples
<form id="my-form">
<fieldset id="my-fieldset">
<legend>Mon ensemble de champs</legend>
<p>
<label for="username">Nom d'utilisateur :</label>
<input type="text" id="username" name="username" />
</p>
<p>
<label for="password">Mot de passe :</label>
<input type="password" id="password" name="password" />
</p>
<p>
<input type="checkbox" id="remember-me" name="remember-me" />
<label for="remember-me">Se souvenir de moi</label>
</p>
</fieldset>
</form>
const fieldset = document.getElementById("my-fieldset");
console.log(fieldset.elements.length); // 3
console.log(fieldset.elements["remember-me"].value); // "on"
Spécifications
| Specification |
|---|
| HTML # dom-fieldset-elements-dev |