Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

fieldset – združevanje kontrolnikov obrazca

Element `fieldset` združuje povezane kontrolnike ali drugo vsebino. Izbirni `legend` skupini doda napis, `disabled` pa onemogoči njene kontrolnike, razen potomcev njenega prvega otroka `legend`.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

fieldset predstavlja skupino kontrolnikov obrazca ali drugo vsebino. Izbirni legend postavite kot prvega otroka tipa element, da skupini dodate napis. Za označevanje posameznih polj še naprej uporabljajte label. Odpiralna in zaključna oznaka sta obvezni.

Prisotnost atributa disabled onemogoči kontrolnike v skupini, razen tistih znotraj njenega prvega otroka legend. Onemogočeni kontrolniki so pri sestavljanju podatkov obrazca izpuščeni. Pri ugnezdenih skupinah odstranitev notranjega disabled ne odpravi onemogočenosti, podedovane od zunanje skupine.

form določa obrazec, povezan s samim fieldset; kontrolnikov potomcev s tem ne poveže samodejno s tem obrazcem. name omogoča iskanje skupine prek form.elements, vendar za skupino ne ustvari vnosa ime–vrednost v poslanih podatkih.

Primer primerja podatke pred nastavitvijo group.disabled = false in po njej. Označeni kontrolnik v legend se pojavi v obeh zbirkah podatkov; email samo v drugi. Koda prikaže rezultat v result, ne da bi obrazec poslala.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri