Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

fieldset — raggruppare i controlli del modulo

L’elemento `fieldset` raggruppa controlli correlati o altri contenuti. Un `legend` facoltativo assegna una didascalia al gruppo, mentre `disabled` disattiva i controlli, tranne i discendenti del suo primo elemento figlio `legend`.

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

Sintassi

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

fieldset rappresenta un gruppo di controlli del modulo o altri contenuti. Inserisci un legend facoltativo come primo elemento figlio per assegnare una didascalia al gruppo. Continua a usare label per identificare i singoli campi. I tag di apertura e chiusura sono obbligatori.

La presenza di disabled disattiva i controlli all’interno del gruppo, tranne quelli nel suo primo elemento figlio legend. I controlli disattivati vengono omessi quando si creano i dati del modulo. Nei gruppi annidati, rimuovere un disabled interno non annulla la disattivazione ereditata da un gruppo esterno.

form identifica il modulo associato al fieldset stesso; non associa automaticamente i controlli discendenti a quel modulo. name consente di trovare il gruppo tramite form.elements, ma non crea una voce nome-valore per il gruppo nei dati inviati.

L’esempio confronta i dati prima e dopo aver impostato group.disabled = false. Il controllo selezionato in legend appare in entrambi gli insiemi di dati; email appare solo nel secondo. Il codice mostra il risultato in result senza inviare il modulo.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti