Znacznik HTMLFormularze

<legend>

Podpis grupy pól `<fieldset>`, wyświetlany na jej ramce.

Wyświetlanie
block
Znacznik zamykający
Wymagany
Dozwolona zawartość
Treść frazowa, opcjonalnie z nagłówkami <h1>–<h6>
Na tej stronie

Przykład

#
HTML
<fieldset>
  <legend>Jak często chcesz się uczyć?</legend>
  <label><input type="radio" name="pace" value="daily"> Codziennie</label>
  <label><input type="radio" name="pace" value="weekly" checked> Kilka razy w tygodniu</label>
  <label><input type="radio" name="pace" value="weekend"> W weekendy</label>
</fieldset>
Podgląd

Definicja i zastosowanie

#

Element <legend> nadaje nazwę grupie pól. Musi być pierwszym dzieckiem elementu <fieldset>. Przeglądarka rysuje go w wyjątkowy sposób: tekst przerywa górną krawędź ramki, jak tytuł wpisany w obramowanie.

Czytniki ekranu używają legendy jako nazwy całej grupy. Przy pytaniach z przyciskami radiowymi legenda powinna zawierać samo pytanie, na przykład „Jak często chcesz się uczyć?”, a etykiety przycisków tylko odpowiedzi.

W środku możesz umieścić treść frazową, a jeśli grupa jest dużą sekcją formularza, nawet nagłówek (<h1>–<h6>).

Składnia

#
Składnia
<fieldset>
  <legend>Podpis grupy</legend>
  …
</fieldset>

Atrybuty

#

Ten element nie ma własnych atrybutów. Obsługuje atrybuty globalne, takie jak class, id czy hidden.

Domyślny CSS

#

Większość przeglądarek wyświetla ten element z takimi stylami domyślnymi:

CSS
legend {
  display: block;
  padding-inline: 2px;
}

Obsługa przeglądarek

#

Szeroko dostępne

Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.

  • Chrome
  • Edge
  • Firefox
  • Safari

Dobre praktyki

#
  • Pisz krótkie legendy. Niektóre czytniki ekranu powtarzają je przy każdym polu w grupie.
  • Legenda działa tylko jako pierwsze dziecko <fieldset>. W innym miejscu to zwykły tekst bez specjalnego znaczenia.

Powiązane hasła

#

Widzisz błąd albo brakuje przykładu? Napisz do nas.