Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

fieldset — regrouper des contrôles de formulaire

L’élément `fieldset` regroupe des contrôles associés ou d’autres contenus. Un `legend` facultatif donne un intitulé au groupe, tandis que `disabled` désactive ses contrôles, sauf les descendants de son premier enfant `legend`.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<fieldset [disabled] [form="form-id"] [name="group-name"]>
  <legend>Group caption</legend>
  <!-- Related controls and other flow content -->
</fieldset>

fieldset représente un groupe de contrôles de formulaire ou d’autres contenus. Placez un legend facultatif comme premier enfant élément afin de donner un intitulé au groupe. Utilisez toujours label pour désigner les champs individuels. Les balises ouvrante et fermante sont requises.

La présence de disabled désactive les contrôles à l’intérieur du groupe, sauf ceux qui se trouvent dans son premier enfant legend. Les contrôles désactivés sont omis lors de la construction des données du formulaire. Dans des groupes imbriqués, supprimer un disabled interne ne neutralise pas la désactivation héritée d’un groupe externe.

form identifie le formulaire associé au fieldset lui-même ; il n’associe pas automatiquement les contrôles descendants à ce formulaire. name permet de retrouver le groupe via form.elements, mais ne crée pas d’entrée nom-valeur pour le groupe dans les données envoyées.

L’exemple compare les données avant et après l’affectation de group.disabled = false. Le contrôle coché dans legend apparaît dans les deux jeux de données ; email apparaît uniquement dans le second. Le code affiche le résultat dans result sans envoyer le formulaire.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>fieldset example</title>
<form id="settings">
  <fieldset id="group" disabled>
    <legend><label><input type="checkbox" name="enabled" checked> Notifications</label></legend>
    <label>Email <input type="email" name="email" value="ada@example.com"></label>
  </fieldset>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('settings');
  const group = document.getElementById('group');
  const snapshot = () => JSON.stringify([...new FormData(form)]);
  const before = snapshot();
  group.disabled = false;
  document.getElementById('result').textContent =
    before + '\n' + snapshot();
</script>
</html>

Résultat

[["enabled","on"]]
[["enabled","on"],["email","ada@example.com"]]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources