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.