Eine Feldkonfiguration bietet die Möglichkeit eine beliebige Konfiguration an ein Datenbankfeld anzufügen. Diese Konfiguration steht dadurch im Programmcode zur Verfügung und kann genutzt werden.
Eine Feldkonfiguration kann entweder über die Datenbankwidgets oder die Datenmodellierung hinzugefügt werden.
Konfiguration
Sonderfall Benutzerdefiniertes Feld bzw. feature
Wurde der Formulartyp eines Datenbankfeldes auf Benutzerdefiniertes Feld bzw. feature gesetzt, dann ist zwingend eine Feldkonfiguration notwendig. Diese wird benötigt um einen Einstiegspunkt für brandbox zu definieren um das entsprechende Feld aufzubauen.
Optional Standardkonfiguration
Ab Version 5.4 besitzt jedes Datenbankfeld zwei Standardkonfigurationen. Diese ermöglichen eine Veränderung der Felddarstellung. Beide Konfigurationsoptionen stehen sowohl in der Datenmodellierung als auch in den Datenbankwidget zur Verfügung.
| Parameter | Datentyp | Standardwert | Beschreibung |
|---|---|---|---|
vertical | boolean | false | Standardmäßig werden in brandbox Label und Feld nebeneinander dargestellt. Wird diese Einstellung auf true gesetzt, wird brandbox angewiesen Label und Feld untereinander darzustellen. |
columns | integer | 12 | Ein Formular ist in brandbox in ein 12-spaltiges Layout unterteilt. Standardmäßig belegt jedes Feld, gemeinsam mit seinem Label, 12 Spalten. Diese Konfiguration kann genutzt werden um einem Feld eine maximale Anzahl an zu belegenden Spalten vorzugeben und dadurch die maximale Breite dieses Feldes zu beeinflussen. |
Programmatischer Zugriff
Wurde eine Konfiguration bei einem Datenbankfeld gepflegt, so kann innerhalb des Programmcodes darauf zugegriffen werden. Hierfür ist die Felddefinition als Klasse des Interfaces \brandbox\component\widget\lib\widget\interfaces\columnInterface notwendig. Genauere Informationen hierzu in der entsprechenden Dokumentation.
$column = $widget->getColumn('myColumnIdentifier'); // Felddefinition
$configuration = $column->getConfiguration(); // Benutzerdefinierte Feldkonfiguration als Array
var_dump($configuration);