Business App Leitfaden für Anpassungen

13.1. Klassen

WidgetBase

Interne Basis von das Widget System. Stellt basis, überschreibare Funktionalität für die Entwicklung von Widgets. Überschreibare Methoden für Widget Entwicklern:

  • IsValid für die Validierung des Widgets in der Konfiguration,
  • SkipRender für den Fall, dass unter Umstände das Widget nicht gerendert sein soll,
  • GetStyleString für die Inline Style eines Widgets,
  • GetCssClass um eine Css Klasse auf höchstes Niveau in der Widgets HTML zu setzen,
  • GetTSClassName um eine angepasste .ts Klasse für das Widget zu setzen,
  • GetUISetting um Benutzerspezifische UI Widget Einstellungen zu lesen,
  • SetUISetting um Benutzerspezifische UI Widget Einstellungen zu speichern,
  • GetUISettingValueForUserOrConfig um Benutzerspezifische UI Widget Einstellungen zu lesen oder aus der Konfiguration, wenn es keine Benutzerspezifisches Wert gibt,
  • GetControllerParameters um spezifischen Parameters für den Controller zu setzen,

Widget Ausrichtungen

WidgetBase beinhaltet auch die Definitionen zur vertikalen und horizontalen Ausrichtung. Werden die beiden Feldern konfiguriert, erhält das Widget entsprechende CSS-Klassen. In der Regel sind diese aber nicht ausreichend. Die Ausrichtung des eigenen Inhaltes muss man entsprechend den Einstellungen mithilfe eigener CSS-Klassen selbst sicherstellen.

LayoutWidget

LayoutWidget erbt von WidgetBase und wird für Widgets, die als Container anderen Widgets gedacht sind und eine Struktur in der Seite definieren. Zum Beispiel die Zeile und Spalten Widgets.

LayoutWidget bereitet die Funktionalität für das SkipRender von Widgets, indem alle die unterliegenden Widgets überprüft werden.

Widget

Widget erbt von WidgetBase und wird die Basis für alle die Widgets, die für die Anzeige gedacht sind. Zum Beispiel ein NavigationMenuWidget oder ein GoogleMapsWidget.

DataWidget

Widgets können Data von der Seite oder anderen Widgets lesen. Dafür soll das Widget von der Klasse DataWidget<T> erben (wo T ist der Parametertyp, den das Widget nutzt. Mehr dazu im Kapitel Basis Parameter Klassen).