Fields

Work in progress

This documentation is work in progress and certainly not complete. If you have any questions, please contact Thomas Breitner or simply open an issue.

Bedeutung der Attribute eines Formularfeldes:

Label

Feldname, wird über dem Eingabefeld dargestellt.

Feldnamen nicht nachträglich ändern

Feldnamen (Label) sollten nachträglich nicht mehr verändert werden, da sonst der Datenexport die Felder nicht mehr korrekt zuordnen kann.

Help text (optional)

Erläuterungstext - auch längere Text inkl. Links. Werden “gedimmt” unterhalb des Eingabefeldes dargestellt. Siehe auch Placeholder.

Required (optional)

Definiert, ob das Ausfüllen dieses Feldes für die Formularabsendung notwendig ist. Diese Felder werden im Formular automatisch mit einem * markiert.

Field type

Feldtyp.

Choices (optional)

Nur für Auswahlfelder (siehe Feldtyp) relevant. Definiert die Ausprägungen von Auswahlfeldern.

Default value (optional)

Standardwert, falls ein Feld nicht ausgefüllt wird.

Placeholder (optional)

Kurzer Hinweistext der im Eingabefeld dargestellt wird und verschwindet, sobald das Feld ausgefüllt wird. Ähnlich wie Help text.

Heading (optional)

Überschrift, die über dem entsprechenden Feld dargestellt wird. Kann z.B. genutzt werden, um größere Formulare zu unterteilen.

CSS class names (optional)

Eigene CSS-Klassen können hier, mit Leerzeichen getrennt, angegeben werden. Die meisten CSS-Klassen des verwendeten User-Interface-Frameworks Bootstrap5 sollten unterstützt sein. Die CSS-Klasse(n) werden auf ein Container-Element des jeweiligen Feldes angewandt.

Verwendungsmöglichkeiten (Auszug):

  • Trennlinie vor dem Feld: border-top pt-2 mt-2

  • Hervorheben des gesamten Feldes inkl. aller Attribute (Hilfetext etc.): alert alert-info

Inline selects

Sollen Radio-Buttons oder Checkboxen “inline” (in einer Zeile statt untereinander) dargestellt werden, kann die Klasse to-form-check-inline genutzt werden.

Sekundäre Felder

Über die CSS-Klasse field-secondary können Felder weniger prominent dargestellt werden (etwas kleiner Input-Bereich, Schriftfarbe zurückgenommen).