Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

legend — podpis grupy

Element `legend` nadaje podpis grupie w `fieldset` lub etykietę grupie opcji w `optgroup`. Musi być pierwszym elementem potomnym; nie zastępuje etykiet poszczególnych kontrolek.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<fieldset>
  <legend>Group caption</legend>
  <!-- Group contents -->
</fieldset>

legend umieszczony jako pierwszy element potomny fieldset opisuje pozostałą zawartość grupy. Używaj go do wspólnego pytania lub nazwy grupy, a label do opisu poszczególnych kontrolek.

Oba znaczniki są wymagane. Element przyjmuje atrybuty globalne. W fieldset może zawierać treść frazową, na przykład tekst i wyróżnienia, opcjonalnie przeplataną nagłówkami. Nie jest dowolnym kontenerem blokowym.

legend jest też dozwolony jako pierwszy element potomny optgroup, gdzie określa etykietę grupy opcji. W tym kontekście dopuszcza wyłącznie treść frazową, bez treści interaktywnej i potomków z atrybutem tabindex.

Gdy fieldset ma disabled, wyłączenie nie obejmuje kontrolek wewnątrz jego pierwszego dziecka legend; inne przyczyny nadal mogą je wyłączyć. Właściwość DOM legend.form tylko do odczytu zwraca formularz rodzica fieldset lub null; bez takiego rodzica również zwraca null.

Przykłady

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

Wynik

Contact method
preferences

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła