Feldgruppen (Fieldsets)¶
Zusammengehörende Felder lassen sich zu einer Feldgruppe bündeln. Technisch
wird die Gruppe als HTML-<fieldset> mit einer <legend> gerendert — das ist
das Standard-Mittel, um Formularabschnitte barrierefrei zu benennen:
Screenreader kündigen den Gruppennamen an, sobald man ein Feld der Gruppe
betritt. Optional bekommt die Gruppe einen sichtbaren Rahmen, der die Felder
auch optisch zusammenfasst — im Web und im PDF.
Feldgruppen lassen sich bis zu zwei Ebenen tief verschachteln (eine Gruppe in einer Gruppe).

Zwei Varianten¶
| Variante | Rahmen | Legende | Einsatz |
|---|---|---|---|
| Semantisch | kein Kasten | für Screenreader vorhanden (visuell versteckt) | Gruppierung nur für Barrierefreiheit, ohne das bestehende Layout optisch zu verändern. Ein sichtbarer Anker ist meist ohnehin eine Sektions-Überschrift darüber. |
| Mit Rahmen (Box) | sichtbarer Kasten | sichtbar auf dem Rahmen | Die Felder sollen auch optisch klar eingeschlossen sein. |
Eine Gruppe anlegen¶
Feldgruppen werden über Start- und Ende-Markierungen an Feldern definiert: Das erste Feld der Gruppe trägt den Fieldset-Start, das letzte das Fieldset-Ende. Alle dazwischenliegenden Felder gehören zur Gruppe. Beides stellst du in den Feld-Eigenschaften im Reiter Sichtbarkeit unter Feldgruppe (Barrierefreiheit) ein.
- Erstes Feld auswählen → Fieldset-Start (Gruppe beginnt hier) ankreuzen.
- Optional eine Legende (Gruppenname) eintragen. Leer = der Titel bzw. die Überschrift des Start-Feldes wird als Name verwendet.
- Optional Sichtbarer Rahmen ankreuzen, wenn die Gruppe einen Kasten bekommen soll.
- Letztes Feld auswählen → Fieldset-Ende (Gruppe endet hier) ankreuzen.
Überschrift als Rahmen-Titel
Markierst du eine Sektions-Überschrift als Box-Start, wird sie automatisch zur Legende des Rahmens (sie erscheint also nicht doppelt) und behält dabei ihre Größe und Farbe. So sieht der Kasten-Titel aus wie eine reguläre Abschnitts-Überschrift.
Markierungen im Editor erkennen¶
In der Vorschau des Formular-Editors sind Start und Ende als farbige Punkte oben rechts am Feld sichtbar:
- Ein Punkt = Gruppen-Start, zwei Punkte = Gruppen-Ende.
- Grün = äußere Ebene (Ebene 1), blau = verschachtelte Ebene (Ebene 2).
Gruppen verschachteln (2 Ebenen)¶
Eine Gruppe darf innerhalb einer anderen liegen. Öffnest du bei bereits offener Gruppe eine weitere (ein zweites Fieldset-Start), wird sie automatisch zur inneren Gruppe (Ebene 2, blaue Marker). Mehr als zwei Ebenen sind bewusst nicht möglich — der Editor blendet dann den Hinweis „Maximal 2 Ebenen" ein und sperrt einen weiteren Start.

Wo endet welche Gruppe?¶
Sind an einer Stelle zwei Gruppen offen und du markierst ein Fieldset-Ende, fragt der Editor per Dropdown „Welche Gruppe endet hier?":
- Nur innere Gruppe — die innere Gruppe endet hier, die äußere läuft weiter (die folgenden Felder gehören wieder zur äußeren Gruppe).
- Innere + äußere Gruppe — beide Gruppen enden an diesem Feld.
Ist nur eine Gruppe offen, entfällt die Frage (das Ende schließt sie eindeutig).
Im PDF¶
Der PDF-Export übernimmt die Feldgruppen vollständig:
- Rahmen werden gezeichnet, verschachtelte Gruppen erscheinen eingerückt.
- Läuft eine Gruppe über mehrere Seiten, bekommt jedes Seitenstück seinen eigenen Rahmen; die Legende steht am Anfang.
- Die Struktur ist als Tagged PDF hinterlegt (
Sect-Container, verschachtelt) — die Formular-PDFs bleiben PDF/UA-1-konform (mit veraPDF geprüft).
Tipps & Grenzen¶
- Feldgruppen wirken im fließenden Layout. Im absolut positionierten Druck-Layout (pixelgenaue Platzierung) sind sie deaktiviert.
- Die Legende ist zugleich der Screenreader-Name der Gruppe — kurz und aussagekräftig halten (z. B. „Bankverbindung", nicht „Gruppe 2").
- Flach halten: Die Begrenzung auf zwei Ebenen entspricht der Empfehlung für barrierefreie Formulare; tiefere Schachtelung wird für Screenreader-Nutzende schnell unübersichtlich.
Referenz: Schema-Schlüssel¶
Diese Einstellungen entsprechen folgenden kc:-Eigenschaften am Feld (werden vom
Editor gesetzt — hier nur zur Orientierung):
| Schlüssel | Bedeutung |
|---|---|
kc:fieldsetStart |
Gruppe beginnt an diesem Feld. |
kc:fieldsetEnd |
Gruppe (die innerste offene) endet an diesem Feld. |
kc:fieldsetEndOf |
schließt die benannte Gruppe und alle noch offenen Kind-Gruppen (= „innere + äußere" zusammen). |
kc:fieldsetLegend |
Gruppenname/Legende (leer = Titel/Überschrift des Start-Feldes). |
kc:fieldsetBox |
sichtbarer Rahmen um die Gruppe. |

