CKTIS / HTML
legend — naslov skupine
Element `legend` opiše skupino v `fieldset` ali označi skupino možnosti v `optgroup`. Biti mora prvi elementni otrok in ne nadomesti oznak posameznih kontrolnikov.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Element legend, postavljen kot prvi elementni otrok elementa fieldset, opiše preostalo vsebino skupine. Uporabite ga za skupno vprašanje ali ime skupine, element label pa za posamezne kontrolnike.
Obe oznaki sta obvezni. Element sprejema globalne atribute. Znotraj fieldset lahko vsebuje frazno vsebino, na primer besedilo in poudarke, po želji prepleteno z naslovi. Ni neomejen vsebnik blokov.
legend je dovoljen tudi kot prvi elementni otrok elementa optgroup, kjer poda oznako skupine možnosti. V tem kontekstu je dovoljena samo frazna vsebina, brez interaktivne vsebine in brez potomcev z atributom tabindex.
Če ima fieldset atribut disabled, ta onemogočitev ne velja za kontrolnike znotraj njegovega prvega otroka legend; drugi vzroki jih lahko kljub temu onemogočijo. Lastnost DOM legend.form, ki je samo za branje, vrne obrazec nadrejenega fieldset ali null; če takega nadrejenega elementa ni, prav tako vrne null.
Primeri
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Legend example</title>
<form id="preferences">
<fieldset>
<legend id="caption">Contact method</legend>
<label><input type="radio" name="contact" value="email" checked> Email</label>
<label><input type="radio" name="contact" value="phone"> Phone</label>
</fieldset>
</form>
<script>
const caption = document.getElementById('caption');
console.log(caption.textContent);
console.log(caption.form.id);
</script>
</html>Rezultat
Contact method preferences
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.