CKTIS / HTML
legend — Gruppenbeschriftung
Das Element `legend` beschriftet eine Gruppe in `fieldset` oder eine Optionsgruppe in `optgroup`. Es muss das erste Elementkind sein und ersetzt nicht die Beschriftungen einzelner Steuerelemente.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Ein legend als erstes Elementkind von fieldset beschriftet den übrigen Inhalt der Gruppe. Verwende es für eine gemeinsame Frage oder einen Gruppennamen und label für einzelne Steuerelemente.
Beide Tags sind erforderlich. Das Element akzeptiert globale Attribute. Innerhalb von fieldset kann es Textinhalte enthalten, etwa Text und Hervorhebungen, optional mit Überschriften dazwischen. Es ist kein uneingeschränkter Block-Container.
legend ist auch als erstes Elementkind von optgroup zulässig und liefert dort die Beschriftung der Optionsgruppe. In diesem Kontext sind nur Textinhalte erlaubt, keine interaktiven Inhalte und keine Nachfahren mit einem tabindex-Attribut.
Ist ein fieldset mit disabled versehen, gilt diese Deaktivierung nicht für Steuerelemente innerhalb seines ersten legend-Kindes; andere Gründe können sie dennoch deaktivieren. Die schreibgeschützte DOM-Eigenschaft legend.form gibt das Formular des übergeordneten fieldset oder null zurück. Ohne ein solches übergeordnetes Element gibt sie ebenfalls null zurück.
Beispiele
<!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>Ergebnis
Contact method preferences
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.