Dynamische Radio- oder Checkboxen-Auswahl (Input/Selection)

Dieses Paket stellt ein dynamisches Eingabefeld für Component/Form zur Verfügung. Der Anwender kann hier eine Auswahl aus einer Liste von Radio- oder Checkboxen-Elementen treffen. Die verfügbaren Auswahloptionen werden dabei durch eine programmatische Quelle bereitgestellt.

Eingabefelddefinition

Die folgende JSON-Definition kann innerhalb einer widget.json, einer modelling.json oder einer Strukturdefinition genutzt werden.

{
    "identifier": "[Eingabefeldidentifikation]",
    "type": "Selection",
    "configuration": {
        "source": "[Auswahlquelle]",
        "InputSelectionResettable": true
    }
}

Konfigurationsoptionen

Die nachfolgenden Konfigurationsoptionen stehen zur Verfügung und können in den Definitionen genutzt werden.

Option	Standardwert	Beschreibung

Option	Standardwert	Beschreibung
`source`	`n.A.`	Die zu nutzende Auswahlquelle, welche in dem vorgsehenen Event zur Verüfung steht.
`InputSelectionResettable`	`false`	Wird diese Option auf `true` gesetzt, wird bei einer Radioauswahl eine Schaltfläche zum Aufheben der aktuellen Auswahl bereitgestellt.

Auswahlquelle

Dieses Eingabefeld arbeitet, ähnlich wie Input/Select, mit einer Auswahlquelle. Diese besteht aus einer frei wählbaren Zeichenkette und muss in der Konfiguration des Eingabefeldes angegeben werden. Über das Event OnPopulateElements können dann die verüfbaren Auswahloptionen definiert werden. Die angegebene Auswahlquelle wird innerhalb des Events über die Eigenschaft source bereitgestellt.

Eine Auswahloption muss mit der Klasse SelectionElement definiert werden. Hier können der anzuzeigende Text sowie der abzuspeichernde Wert festgelegt werden.

Events

Die nachfolgenden PHP-Events werden durch dieses Paket bereitgestellt.

Eventname	Beschreibung

Eventname	Beschreibung
`OnPopulateElements`	Dieses Event wird ausgeführt, um alle verfügbaren Auswahloptionen für eine Auswahlquelle einzusammeln. Die zu nutzenden Auswahlquelle wird innerhalb des Events bereitgestellt.