Layout

Mit dem Layout-Modul designst du Layouts ganz nach deinen Vorstellungen, z.B. ausklappbare Menüs, interaktive Formulare oder einladende Dashboards. Bei der Programmierung unseres Layouts hatten wir zwei Hauptziele: hohe Flexibilität und optimierter Basiscode. Dadurch sind unsere Layouts wesentlich schneller als andere Lösungen und erzeugen keine Performance-Probleme.

Funktion und Aussehen

Das Layout basiert auf dem Konzept von Blocks, also Blöcken, die du entweder horizontal (von links nach rechts) oder vertikal (von oben nach unten) anordnen kannst. Der Inhalt der Blocks ist frei gestaltbar und kann beispielsweise Text, andere GIP- oder arcRider-Module sowie HTML-Elemente enthalten. Lasse deiner Kreativität freien Lauf. Außerdem kannst du dank des Style-Keys deinen Layouts und Blocks mit Inline-CSS eine individuelle Optik geben.

Nutzer-Interaktion

Auch bei der Gestaltung der Nutzer-Interaktion mit dem Modul lassen wir dir alle Freiheiten. Sowohl dem Layout selbst, als auch den Blocks kannst du eine beliebige Anzahl an Actions zuweisen. Jede Action besteht aus einem auslösenden Trigger und einem Array von Scripts, die bei Auslösen des Triggers ausgeführt werden. Als Trigger können Klick, Mausbewegung und alle weiteren HTML Mouse Events eingesetzt werden. Je nach Anwendung können auch andere HTML Events funktionieren. Eine Liste solcher Events findest du beispielsweise hier. Weitere Infos zu Actions findest du in diesem Teil unserer Doku.

Modulcode

Vollständiger Code

GIP_layout({
   uniqueId: "",
   embedded: {
   	height: "",
   	styleHtml: "",
   	styleStri: "",
   },
   direction: "",
   style: "",
   blocks: [{
   	style: "",
   	value: *any*,
   	actions: [{
   		trigger: "",
   		scripts: [{
   			type: "",
   			tableId: "",
   			viewId: "",
   			recordId: "",
   			tab: "",
   			fieldId: "",
   			dialogId: "",
   			value: *any*,
   			changeFieldValues: [{
   				fieldId: "",
   				value: *any*,
   			}],
   			displayAfterCreate: "",
   			setNewRecordId: [{
   				recordId: "",
   				fieldId: "",
   			}],
   			showCloseButton: true,
   			showAsModal: true,
   		}],
   	}],
   }],
   actions: [{
   	trigger: "",
   	scripts: [{
   		type: "",
   		tableId: "",
   		viewId: "",
   		recordId: "",
   		tab: "",
   		fieldId: "",
   		dialogId: "",
   		value: *any*,
   		changeFieldValues: [{
   			fieldId: "",
   			value: *any*,
   		}],
   		displayAfterCreate: "",
   		setNewRecordId: [{
   			recordId: "",
   			fieldId: "",
   		}],
   		showCloseButton: true,
   		showAsModal: true,
   	}],
   }],
})

Minimaler Code

GIP_layout({
   uniqueId: "",
   embedded: {
   },
   blocks: [{
   	value: *any*,
   }],
})

Vollständiger Code mit Master

html( raw(GIP_master({})) + 
raw(GIP_layout({
   uniqueId: "",
   embedded: {
   	height: "",
   	styleHtml: "",
   	styleStri: "",
   },
   direction: "",
   style: "",
   blocks: [{
   	style: "",
   	value: *any*,
   	actions: [{
   		trigger: "",
   		scripts: [{
   			type: "",
   			tableId: "",
   			viewId: "",
   			recordId: "",
   			tab: "",
   			fieldId: "",
   			dialogId: "",
   			value: *any*,
   			changeFieldValues: [{
   				fieldId: "",
   				value: *any*,
   			}],
   			displayAfterCreate: "",
   			setNewRecordId: [{
   				recordId: "",
   				fieldId: "",
   			}],
   			showCloseButton: true,
   			showAsModal: true,
   		}],
   	}],
   }],
   actions: [{
   	trigger: "",
   	scripts: [{
   		type: "",
   		tableId: "",
   		viewId: "",
   		recordId: "",
   		tab: "",
   		fieldId: "",
   		dialogId: "",
   		value: *any*,
   		changeFieldValues: [{
   			fieldId: "",
   			value: *any*,
   		}],
   		displayAfterCreate: "",
   		setNewRecordId: [{
   			recordId: "",
   			fieldId: "",
   		}],
   		showCloseButton: true,
   		showAsModal: true,
   	}],
   }],
})
))

Key-Table

arrow_rightuniqueIdRequired string Default: - Eindeutige Kennung des eingesetzten Moduls. Ideal ist eine Kombination aus Text und der Record-ID, also z.B.: uniqueId: "LayoutÜberschrift" + Nr Ist die ID nicht einzigartig, kann es zu Fehlern bei Anzeige und Funktion der eingesetzten Module in der Tabelle kommen.

arrow_rightembeddedRequired boolean, object Default: false Wenn des Modul in einem anderen Modul eingebettet ist, wird der boolesche Wert true eingetragen. Liegt das Modul alleine, bzw. als äußerster Container in einem Formelfeld, kann entweder false oder ein Object mit Angaben zur Höhe und Styling des Formelfeldes angegeben werden.

arrow_rightheight string Default: "auto" Höhe des Moduls in Pixeln (px).

arrow_rightstyleHtml string Default: - Inline CSS-Styling des Html-Containers des Formel-Feldes, in dem die GIP-Module liegen.

arrow_rightstyleStri string Default: - Inline CSS-Styling des Stringeditor-Containers des Formel-Feldes, in dem die GIP-Module liegen.

arrow_rightdirection string Default: "horizontal" Für die Ausrichtung der Blöcke des Moduls gibt es die Befehle "horizontal" (von links nach rechts nebeneinander) und "vertical" (von oben nach unten untereinander).

arrow_rightstyle string Default: Siehe Globaler CSS-Code Inline CSS-Styling des Moduls.

arrow_rightblocksRequired array of objects Default: - Enthält ein Array der Inhaltsblocks des Moduls. Für jeden Block können Wert, Styling und Aktionen bei Interaktion mit dem Block angegeben werden.

arrow_rightstyle string Default: Siehe Globaler CSS-Code Inline CSS-Styling des Moduls.

arrow_rightvalueRequired any Default: - Eingabe des gewünschten Wertes.

arrow_rightactions array of objects Default: - Enthält ein Array mehrerer Actions. Jede Action ist aus einem Trigger, der die Action auslöst, und einem Array der auszuführenden Funktionen nach Auslösen des Triggers (Script) aufgebaut.

arrow_righttriggerRequired string Default: - Legt fest, durch welche User-Eingaben die Funktionen der Action ausgelöst werden. Als Trigger können alle HTML Mouse Events gewählt werden.

arrow_rightscriptsRequired array of objects Default: - Enthält ein Array der Funktionen, die durch den Trigger der Aktion ausgeführt werden.

arrow_righttypeRequired string Default: - Der Typ der Funktion wird aus der Liste der verfügbaren Funktionen gewählt.

arrow_righttableIdRequired string Default: - ID der Ziel-Tabelle.

arrow_rightviewId string Default: - ID des Ziel-Views. ::: warning Achtung Für viewId muss die View-ID und nicht der View-Name angegeben werden. Um die View-ID zu erhalten, öffnet man den View der Tabelle (ohne einen Record zu öffnen), klickt in die URL und kopiert den String hinter dem letzten Slash (/). Die View-ID der URL "..../module/T/view/AbyXqEZayZPQgjFm" ist demnach "AbyXqEZayZPQgjFm".

arrow_rightrecordIdRequired string Default: - ID des Ziel-Records.

arrow_righttab string Default: - Name des Ziel-Tabs.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightdialogIdRequired string Default: - Hier ist die uniqueId des Ziel-Dialogs anzugeben.

arrow_rightvalueRequired any Default: - Eingabe des gewünschten Wertes.

arrow_rightchangeFieldValues array of objects Default: - Schreibt Werte in Ziel-Felder eines neu erstellten Records.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightvalueRequired any Default: - Eingabe des gewünschten Wertes.

arrow_rightdisplayAfterCreate string Default: - Öffnet einen neu erstellten Record wahlweise direkt, als Popup oder als Vollbildansicht.

arrow_rightsetNewRecordId array of objects Default: - Schreibt die ID eines neu erstellten Records in Ziel-Felder von Ziel-Records.

arrow_rightrecordIdRequired string Default: - ID des Ziel-Records.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightshowCloseButton boolean Default: - Gibt an, ob ein Schließen-Button in der oberen rechten Ecke des Dialogs angezeigt werden soll. Achtung: Wenn showCloseButton = false ist, sollte der Programmierer die Funktion "closeGIPdialog" in ein Feld einbauen, damit der Nutzer den Dialog wieder schließen kann. Überschreibt den showCloseButton-Status, der im Dialog selbst angegeben ist.

arrow_rightshowAsModal boolean Default: - Gibt an, ob das Dialog-Element als Modal-Element angezeigt werden soll. Modal-Element: Der Nutzer kann nur mit dem Dialog-Element, aber nicht mit den Ninox-Feldern im Hintergrund interagieren, wenn der Dialog geöffnet ist. Nicht-Modal-Element: Die Interaktion mit den Ninox-Feldern im Hintergrund ist weiterhin möglich, wenn der Dialog geöffnet ist. . Überschreibt den showAsModal-Status, der im Dialog selbst angegeben ist.

arrow_rightactions array of objects Default: - Enthält ein Array mehrerer Actions. Jede Action ist aus einem Trigger, der die Action auslöst, und einem Array der auszuführenden Funktionen nach Auslösen des Triggers (Script) aufgebaut.

arrow_righttriggerRequired string Default: - Legt fest, durch welche User-Eingaben die Funktionen der Action ausgelöst werden. Als Trigger können alle HTML Mouse Events gewählt werden.

arrow_rightscriptsRequired array of objects Default: - Enthält ein Array der Funktionen, die durch den Trigger der Aktion ausgeführt werden.

arrow_righttypeRequired string Default: - Der Typ der Funktion wird aus der Liste der verfügbaren Funktionen gewählt.

arrow_righttableIdRequired string Default: - ID der Ziel-Tabelle.

arrow_rightviewId string Default: - ID des Ziel-Views. ::: warning Achtung Für viewId muss die View-ID und nicht der View-Name angegeben werden. Um die View-ID zu erhalten, öffnet man den View der Tabelle (ohne einen Record zu öffnen), klickt in die URL und kopiert den String hinter dem letzten Slash (/). Die View-ID der URL "..../module/T/view/AbyXqEZayZPQgjFm" ist demnach "AbyXqEZayZPQgjFm".

arrow_rightrecordIdRequired string Default: - ID des Ziel-Records.

arrow_righttab string Default: - Name des Ziel-Tabs.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightdialogIdRequired string Default: - Hier ist die uniqueId des Ziel-Dialogs anzugeben.

arrow_rightvalueRequired any Default: - Eingabe des gewünschten Wertes.

arrow_rightchangeFieldValues array of objects Default: - Schreibt Werte in Ziel-Felder eines neu erstellten Records.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightvalueRequired any Default: - Eingabe des gewünschten Wertes.

arrow_rightdisplayAfterCreate string Default: - Öffnet einen neu erstellten Record wahlweise direkt, als Popup oder als Vollbildansicht.

arrow_rightsetNewRecordId array of objects Default: - Schreibt die ID eines neu erstellten Records in Ziel-Felder von Ziel-Records.

arrow_rightrecordIdRequired string Default: - ID des Ziel-Records.

arrow_rightfieldIdRequired string Default: - ID des Ziel-Feldes.

arrow_rightshowCloseButton boolean Default: - Gibt an, ob ein Schließen-Button in der oberen rechten Ecke des Dialogs angezeigt werden soll. Achtung: Wenn showCloseButton = false ist, sollte der Programmierer die Funktion "closeGIPdialog" in ein Feld einbauen, damit der Nutzer den Dialog wieder schließen kann. Überschreibt den showCloseButton-Status, der im Dialog selbst angegeben ist.

arrow_rightshowAsModal boolean Default: - Gibt an, ob das Dialog-Element als Modal-Element angezeigt werden soll. Modal-Element: Der Nutzer kann nur mit dem Dialog-Element, aber nicht mit den Ninox-Feldern im Hintergrund interagieren, wenn der Dialog geöffnet ist. Nicht-Modal-Element: Die Interaktion mit den Ninox-Feldern im Hintergrund ist weiterhin möglich, wenn der Dialog geöffnet ist. . Überschreibt den showAsModal-Status, der im Dialog selbst angegeben ist.