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 |
|---|---|
OnPopulateEnumerationSearch | Wird bei einer Suchanfrage innerhalb eines Auswahlfeldes ausgelöst. Die Klasse PopulateEnumerationAbstract kann als Basisklasse für einen Listener verwendet werden. |
OnPopulateEnumerationValues | Wird bei Aufbau eines Auswahlfeldes ausgelöst und befüllt die derzeit gewählten Einträge. Auch hier darf die Klasse |
OnPopulateElement | Wird beim Aufbau des Auswahlfeldes ausgelöst und kann genutzt werden um die enstehende Styleguidekomponente zu beeinflussen. Hier kann die Klasse PopulateElementAbstract als Basis für einen Listener verwendet werden. |
OnPopulatePayload | 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 payload zur Verfügung. Hier darf die Klasse PopulatePayloadAbstract als Basis für einen Listener verwendet werden. |
OnPopulateSource | Wird zur Definition von verfügbaren Auswahlfeldquellen ausgelöst. Diese Auswahl steht über die Strukturmodellierung einem Anwender zur Verfügung. Hier darf die Klasse PopulateSourceAbstract als Basis für einen Listener genutzt werden. |
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.