CKTIS / HTML
legend — popisek skupiny
Prvek `legend` popisuje skupinu v `fieldset` nebo označuje skupinu možností v `optgroup`. Musí být prvním elementovým potomkem a nenahrazuje popisky jednotlivých ovládacích prvků.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Prvek legend umístěný jako první elementový potomek fieldset popisuje zbývající obsah skupiny. Použijte ho pro společnou otázku nebo název skupiny a label pro jednotlivé ovládací prvky.
Obě značky jsou povinné. Prvek přijímá globální atributy. Uvnitř fieldset může obsahovat frázový obsah, například text a zvýraznění, případně proložený nadpisy. Nejde o neomezený blokový kontejner.
legend je povolen také jako první elementový potomek optgroup, kde poskytuje popisek skupiny možností. V tomto kontextu je povolen pouze frázový obsah, bez interaktivního obsahu a bez potomků s atributem tabindex.
Pokud má fieldset atribut disabled, toto zakázání se nevztahuje na ovládací prvky uvnitř jeho prvního potomka legend; jiné příčiny je však mohou zakázat. Vlastnost DOM legend.form, která je pouze pro čtení, vrací formulář nadřazeného fieldset nebo null; bez takového nadřazeného prvku vrací také null.
Pří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ýsledek
Contact method preferences
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.