Jedes Form-UI-Element <form> wird als separate Editorseite im Instanzeditor angezeigt.
Jedes Form-UI benötigt einen Titel und eine eindeutige ID. Der Titel lässt sich auch mit einer Formel ermitteln, sodass mehrsprachige Form-UIs konfiguriert werden können.
Das Attribut readonly steuert das Verhalten von Elementen, die eine Eingabe im Form-UI ermöglichen. Der Wert des Attributs wird von übergeordneten Elementen (Container-Elementen) an untergeordnete Elemente vererbt, kann von diesen aber überschrieben werden.
Attributname | Verwendung | Attributwerte | Defaultwert | Beschreibung |
---|---|---|---|---|
bColor | optional | 0,0,0 bis 255,255,255 | Hintergrundfarbe als RGB-Wert | |
id | benötigt | beliebig | eindeutige ID, auf die Bezug genommen wird | |
img | optional | png, gif, jpg | weist dem Element ein anderes Bild zu | |
readonly | optional | true, false | true = Form-UI kann nur gelesen werden. false = In Eingabefelder des Form-UIs kann auch geschrieben werden. |
|
title | benötigt | beliebig | Name des Form-UIs | |
visible | optional | true, false | true | true = Form-UI in der Liste der Form-UIs sichtbar false = Form-UI in der Liste der Form-UIs unsichtbar |
Erlaubte Unterelemente | Anzahl |
---|---|
action | beliebig |
group | beliebig |
img | beliebig |
include | beliebig |
input | beliebig |
instantiation | beliebig |
label | beliebig |
line | beliebig |
loop | beliebig |
open | beliebig |
progressBar | beliebig |
table | beliebig |
td | beliebig |
Es sollen 5 leere Form-UIs definiert werden, von denen eines (Titel B) ein eigenes Bild hat, eines (Titel C) nicht in der Liste angezeigt wird und eines (Titel E) mit roter Hintergrundfarbe versehen ist.
<uis>
<form title="Titel A" id="a">
</form>
<form title="Titel B" id = "b" img="install\icon-collection\Rumpf.png">
</form>
<form title="Titel C" id = "c" visible="false">
</form>
<form title="Titel D" id = "d" lazy="true">
</form>
<form title="Titel E" id = "e" bColor="255,100,100">
..</form>
</uis>
Ergebnis:
Ein Form-UI, dass je nach gewählter Sprache einen anderen Titel erhält:
Im Form-UI kann per dropDown-Listenfeld eine Sprache ausgewählt werden. Mit Hilfe einer Formel wird die gewählte Sprache ausgewertet und ein entsprechender Titel eingesetzt. Die Änderung der Sprache wirkt sich erst beim erneuten Laden des Form-UIs aus.
<form title="=switch $Language {
case 'de_DE': 'Sprachauswahl'
case 'en_GB': 'Language selection'
else: 'Language not available'}"
id="language">
<input type="combo" values="=List{Pair{'Deutsch','de_DE'},
Pair{'English','en_GB'}}"
receiver="parameter('Language')"/>
</form>
Ergebnis: