Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

fieldset – seskupení ovládacích prvků formuláře

Element `fieldset` seskupuje související ovládací prvky nebo jiný obsah. Volitelný `legend` skupinu opatří popiskem; `disabled` její ovládací prvky zakáže, s výjimkou potomků jejího prvního potomka `legend`.

Verze: 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 představuje skupinu ovládacích prvků formuláře nebo jiný obsah. Volitelný legend umístěte jako první elementový potomek, aby skupinu opatřil popiskem. K označení jednotlivých polí používejte i nadále label. Počáteční i koncová značka jsou povinné.

Přítomnost atributu disabled zakáže ovládací prvky uvnitř skupiny, kromě těch, které jsou v jejím prvním potomkovi legend. Zakázané ovládací prvky se při vytváření dat formuláře vynechají. U vnořených skupin odstranění vnitřního disabled nezruší zákaz vyplývající z vnější skupiny.

form určuje formulář přiřazený samotnému fieldset; ovládací prvky potomků k tomuto formuláři automaticky nepřiřazuje. name umožňuje skupinu vyhledat přes form.elements, ale nevytváří pro ni v odesílaných datech položku název–hodnota.

Příklad porovnává data před nastavením group.disabled = false a po něm. Zaškrtnutý ovládací prvek v legend se objeví v obou sadách dat; email pouze ve druhé. Kód zobrazí výsledek v result a formulář neodešle.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje