Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

fieldset – zoskupenie ovládacích prvkov formulára

Element `fieldset` zoskupuje súvisiace ovládacie prvky alebo iný obsah. Voliteľný `legend` skupinu označí popisom; `disabled` vypne jej ovládacie prvky okrem potomkov jej prvého potomka `legend`.

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

Syntax

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

fieldset predstavuje skupinu ovládacích prvkov formulára alebo iný obsah. Voliteľný legend umiestnite ako prvého potomka typu element, aby skupinu označil popisom. Naďalej používajte label na označenie jednotlivých polí. Otváracia aj zatváracia značka sú povinné.

Prítomnosť atribútu disabled vypne ovládacie prvky v skupine okrem tých, ktoré sa nachádzajú v jej prvom potomkovi legend. Vypnuté ovládacie prvky sa pri vytváraní údajov formulára vynechajú. Pri vnorených skupinách odstránenie vnútorného disabled nezruší vypnutie zdedené z vonkajšej skupiny.

form identifikuje formulár priradený samotnému fieldset; ovládacie prvky potomkov k tomuto formuláru automaticky nepriradí. name umožňuje vyhľadať skupinu cez form.elements, ale nevytvára pre skupinu položku názov–hodnota v odoslaných údajoch.

Príklad porovnáva údaje pred nastavením group.disabled = false a po ňom. Začiarknutý ovládací prvok v legend sa objaví v oboch súboroch údajov; email iba v druhom. Kód zobrazí výsledok v result bez odoslania formulára.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje