Das Element <dialog> konfiguriert ein modales Dialogfenster zur Anzeige einer Form-UI-Seite. Ein Dialogfenster muss geschlossen werden, um im öffnenden Fenster weiterarbeiten zu können. Das Element wird als Unterelement von <open> konfiguriert. Mit dem Attribut buttons werden Schaltflächen im Dialogfenster eingeblendet um Aktionen, bzw. Commands auszuführen.
Mit Hilfe des Unterelements <command> können vor dem Öffnen und nach dem Schließen Aktionen, bzw. Commands ausgeführt werden (siehe command). Das Anklicken von [Ok] muss immer eine Aktion ausführen, während das Ausführen einer Aktion für [Abbrechen], [Ja] und [Nein] optional ist.
Attributname | Verwendung | Attributwerte | Defaultwert | Beschreibung |
---|---|---|---|---|
buttons | optional | ok, cancel, yes, no | Blendet Schaltflächen im Dialogfenster ein, mit denen Aktionen ausgeführt werden. Mehrere Schaltflächen werden durch '|' getrennt, z.B. buttons="ok|cancel". ok = Ok cancel = Abbrechen yes = Ja no = Nein |
|
hSize | optional | Breite des Elements EEC = Breite in Zeichen Web-Applikation = Breite in Pixel |
||
hSizeMax | optional | maximale Breite des Elements EEC = Breite in Zeichen Web-Applikation = Breite in Pixel |
||
hSizeMin | optional | minimale Breite des Elements EEC = minimale Breite in Zeichen Web-Applikation = minimale Breite in Pixel |
||
visible | optional | true, false | true | true = Label ist sichtbar false = Label ist unsichtbar |
vSize | optional | Höhe des Elements EEC = Höhe in Zeichen Web-Applikation = Höhe in Pixel |
||
vSizeMax | optional | maximale Höhe des Elements EEC = maximale Höhe in Zeichen Web-Applikation = maximale Höhe in Pixel |
||
vSizeMin | optional | minimale Höhe des Elements EEC = minimale Höhe in Zeichen Web-Applikation = minimale Höhe in Pixel |
||
title | optional | Formel zum Text, der als Titel des Dialogs angezeigt wird. |
Erlaubte Unterelemente | Anzahl |
---|---|
command | beliebig |
Eine Schaltfläche öffnet einen modalen Dialog, in dem eine andere Form-UI-Seite angezeigt wird. Sowohl beim Starten des Dialogs als auch beim Schließen wird jeweils eine Aktion ausgeführt:
<form title="Dialog" id="dialog">
<open text="='open dialog'" type="button" ref="modaldialog">
<dialog title="='Modal dialog Title Text'" buttons="ok|cancel" >
<command event="before" name="Documentation_UI_Configuration.ProjectLibrary.HelpObjects.okAction" />
<command event="after" name="Documentation_UI_Configuration.ProjectLibrary.HelpObjects.cancelAction" />
</dialog>
</open>
</form>
<form id="modaldialog" title="Modal Dialog">
<label>[OK] closes the modal dialog and executes the action "okAction"</label>
<label>[Abbrechen] closes the modal dialog and executes the action "cancelAction"</label>
</form>
Ergebnis: