Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

fieldset — grupowanie kontrolek formularza

Element `fieldset` grupuje powiązane kontrolki lub inną treść. Opcjonalny `legend` nadaje grupie podpis, a `disabled` wyłącza kontrolki z wyjątkiem potomków pierwszego elementu potomnego `legend`.

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

Składnia

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

fieldset oznacza grupę kontrolek formularza lub innej treści. Opcjonalny legend umieść jako pierwszy element potomny: nadaje on grupie podpis. Nadal używaj label do opisywania poszczególnych pól. Znaczniki otwierający i zamykający są wymagane.

Obecność disabled wyłącza kontrolki wewnątrz grupy, z wyjątkiem tych w jej pierwszym elemencie potomnym legend. Wyłączone kontrolki są pomijane podczas tworzenia danych formularza. W zagnieżdżonych grupach usunięcie wewnętrznego disabled nie znosi wyłączenia wynikającego z grupy zewnętrznej.

form wskazuje przez identyfikator formularz powiązany z samym fieldset; nie przypisuje automatycznie do niego kontrolek potomnych. name pozwala odszukać grupę przez form.elements, ale nie tworzy dla niej pary nazwa–wartość w wysyłanych danych.

Przykład porównuje dane przed ustawieniem group.disabled = false i po nim. Zaznaczone pole w legend trafia do obu zestawów danych; pole email tylko do drugiego. Kod wypisuje wynik w result, bez wysyłania formularza.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła