CKTIS / HTML
fieldset – Formularsteuerelemente gruppieren
Das Element `fieldset` gruppiert zusammengehörige Steuerelemente oder andere Inhalte. Ein optionales `legend` beschriftet die Gruppe; `disabled` deaktiviert ihre Steuerelemente, mit Ausnahme von Nachfahren des ersten `legend`-Kinds.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<fieldset [disabled] [form="form-id"] [name="group-name"]>
<legend>Group caption</legend>
<!-- Related controls and other flow content -->
</fieldset>fieldset stellt eine Gruppe von Formularsteuerelementen oder anderen Inhalten dar. Setze ein optionales legend als erstes Elementkind ein, um die Gruppe zu beschriften. Verwende weiterhin label, um einzelne Felder zu kennzeichnen. Öffnendes und schließendes Tag sind erforderlich.
Ist disabled vorhanden, werden Steuerelemente innerhalb der Gruppe deaktiviert, mit Ausnahme derjenigen im ersten legend-Kind. Deaktivierte Steuerelemente werden beim Erstellen der Formulardaten ausgelassen. Bei verschachtelten Gruppen hebt das Entfernen eines inneren disabled die Deaktivierung durch eine äußere Gruppe nicht auf.
form bezeichnet das Formular, dem das fieldset selbst zugeordnet ist; Nachfahren-Steuerelemente werden dadurch nicht automatisch diesem Formular zugeordnet. Mit name lässt sich die Gruppe über form.elements finden, es erzeugt aber keinen Name-Wert-Eintrag der Gruppe in den übermittelten Daten.
Das Beispiel vergleicht die Daten vor und nach dem Setzen von group.disabled = false. Das aktivierte Steuerelement in legend erscheint in beiden Datensätzen; email nur im zweiten. Der Code zeigt das Ergebnis in result an, ohne das Formular abzusenden.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>fieldset example</title>
<form id="settings">
<fieldset id="group" disabled>
<legend><label><input type="checkbox" name="enabled" checked> Notifications</label></legend>
<label>Email <input type="email" name="email" value="ada@example.com"></label>
</fieldset>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('settings');
const group = document.getElementById('group');
const snapshot = () => JSON.stringify([...new FormData(form)]);
const before = snapshot();
group.disabled = false;
document.getElementById('result').textContent =
before + '\n' + snapshot();
</script>
</html>Ergebnis
[["enabled","on"]] [["enabled","on"],["email","ada@example.com"]]
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.