Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje