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.