Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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
Codeblock
languagejs
{
  "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 PopulateEnumerationAbstract als Basis für einen Listener verwendet werden.

OnPopulateConfiguration

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 PopulateConfigurationAbstract als Basis für einen Listener eingesetzt werden.

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.


Info

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.