CKTIS / HTML
legend — popis skupiny
Prvok `legend` opisuje skupinu v `fieldset` alebo označuje skupinu možností v `optgroup`. Musí byť prvým elementovým potomkom a nenahrádza popisy jednotlivých ovládacích prvkov.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Prvok legend umiestnený ako prvý elementový potomok fieldset opisuje zvyšný obsah skupiny. Použite ho na spoločnú otázku alebo názov skupiny a label na jednotlivé ovládacie prvky.
Obe značky sú povinné. Prvok prijíma globálne atribúty. Vnútri fieldset môže obsahovať frázový obsah, napríklad text a zvýraznenie, prípadne popretkávaný nadpismi. Nie je to neobmedzený blokový kontajner.
legend je povolený aj ako prvý elementový potomok optgroup, kde poskytuje popis skupiny možností. V tomto kontexte je povolený iba frázový obsah, bez interaktívneho obsahu a bez potomkov s atribútom tabindex.
Ak má fieldset atribút disabled, toto zakázanie sa nevzťahuje na ovládacie prvky vo vnútri jeho prvého potomka legend; iné príčiny ich však môžu zakázať. Vlastnosť DOM legend.form, ktorá je iba na čítanie, vracia formulár nadradeného fieldset alebo null; bez takého nadradeného prvku vracia tiež null.
Príklady
<!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>Výsledok
Contact method preferences
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.