Das Auswahlfeldpaket wird in brandbox als Basis für viele Auswahfelder (bspw. Fremdschlüssel, Symbole, Sprachen, Länder, Kollationen, etc.) verwendet. Hierbei wird ein Select2-Auswahlfeld aufgebaut und über verschiedene Auswahlfeldquellen mit möglichen Werten ausgestattet.
Widgetdefinition eines Auswahlfeldes
{
"type": "Select",
"configuration": {
"source": "[Auswahlfeldquelle]"
}
}
Programmatische Erweiterung
Die nachfolgenden Events stehen für das Auswahlfeldpaket zur Verfügung.
Klassenname | Beschreibung |
|---|---|
| Wird bei einer Suchanfrage innerhalb eines Auswahlfeldes ausgelöst. Die Klasse |
| Wird bei Aufbau eines Auswahlfeldes ausgelöst und befüllt die derzeit gewählten Einträge. Auch hier darf die Klasse |
| Wird ausgelöst um eine optionale Konfigurationsdefinition für die entsprechenden Auswahlfeldquellen zu definieren. Diese Konfiguration steht innerhalb der Strukturmodellierung zur Verfügung. Hier kann die Klasse |
| Wird beim Aufbau des Auswahlfeldes ausgelöst und kann genutzt werden um die enstehende Styleguidekomponente zu beeinflussen. Hier kann die Klasse |
| Wird zur Definition von Zusatzparametern ausgelöst. Diese Parameter werden in eine URL-sichere Zeichenkette umgewandelt und bei jeder Suchanfrage des Auswahlfeldes mitgesendet. Innerhalb der anderen Events stehen diese Informationen über die Eigenschaft |
| Wird zur Definition von verfügbaren Auswahlfeldquellen ausgelöst. Diese Auswahl steht über die Strukturmodellierung einem Anwender zur Verfügung. Hier darf die Klasse |
Werden die entsprechenden Basisklassen für einen Eventlistener eingesetzt, muss die Konstante SOURCES definiert werden. Hierüber werden die Auswahlfeldquellen definiert, für welche dieser Listener zuständig ist.