Business App Leitfaden für Anpassungen

9.2. Messageboxen

Messageboxen unterscheiden sich von Dialogen dadurch, dass sie ein rein Browser basiertes Framework sind. Daher können dort weder Daten noch konfigurierte Auswahllisten genutzt werden. Dafür ist beim Aufruf auch keine Serverinteraktion notwendig, und Sie können damit schneller geöffnet werden.

Beispiel

BA.Ui.MessageBox.ShowYesNo("Titel", "Frage?", 0,  yesFunction, noFunction);

Es können auch einfache Eingaben bzw. Auswahlen durch Messageboxen realisiert werden.

BA.Ui.MessageBox.ShowSelection(
     "Selection", // Titel
     "Bitte was auswählen...", // Text
     0, // Breite. 0 = Default
     false, // Einzelauswahl (ja/nein)
     { Key1: 'Was', Key2: 'soll ich', Key3: 'auswählen?' }, // Werte
     function (result) { console.log("Ok"); console.log(result) }, // Ergebnisfunktion für OK
     function (result) { console.log("Cancel"); console.log(result) } // Ergebnisfunktion für Cancel
);

Der Parameter der Ergebnisfunktion:

  • Ist immer ein Stringarray
  • Meistens mit nur einem Wert: “OK”, “CANCEL”, “YES”, “NO”
  • Oder der im Inputfeld eingegebene Wert
  • Oder in der Einzelauswahl der ausgewählte Schlüssel
  • Oder im Falle einer Mehrfachauswahl alle ausgewählten Schlüssel
  • Die Übergabe der Werte erfolgt auch an die Cancel-Funktion

BA.Ui.MessageBox

public static ShowOk(title: string, message: string, width: number = 400, okBtnCallback?: Function)
public static ShowWarn(title: string, message: string, width: number = 400, okBtnCallback?: Function)
public static ShowError(title: string, message: string, width: number = 400, okBtnCallback?: Function)
public static ShowYesNo(title: string, message: string, width: number = 400, yesBtnCallback?: Function, noBtnCallback?: Function)
public static ShowYesNoCancel(title: string, message: string, width: number, yesBtnCallback?: Function, noBtnCallback?: Function, cancelBtnCallback?: Function)
public static ShowOkCancel(title: string, message: string, width: number = 400, okBtnCallback?: Function, cancelBtnCallback?: Function)
public static ShowPrompt(title: string, message: string, width: number = 400, okBtnCallback?: Function, cancelBtnCallback?: Function)
public static ShowSelection(title: string, message: string, width: number, single: boolean, items: { [key: string]: string }, okBtnCallback?: Function, cancelBtnCallback?: Function)