Die GAPTEQ-Komponente Data Form ist eine Datenformularkomponente, die einzelne Felder und Felder in Gruppen auf eine strukturierte Weise anzeigt.
In diesem Artikel lesen Sie folgende Inhalte:
Examples
Formularfeld in Gruppen |
Label-Varianten der Formularfelder |
Formularfelder mit Auswahlmöglichkeiten |
Tipp! Hier sehen Sie mehr von der Komponente.
1. Data Form Properties
Properties |
Beschreibung |
---|---|
ID |
Bezeichnung / Benamung der Headline |
Color scheme |
Initiale Farbschemen:
|
Konfiguriert über Color Schemes |
|
CSS class |
Elemente einer Gruppe/Klasse zuordnen, für die bestimmte Formatierungen gelten sollen Option 1: in Properties bestehende Bootstrap-Klassen einfügen Option 2: über Hauptmenü in den Page Templates (für “alles verfügbar”) Option 3: Page definitions (nur für diese Seite) |
Tab index |
Legt die Navigation in der Page bzw. im Formular durch die Tab-Taste fest (Tab-Reihenfolge). Für jedes Formularfeld kann ein Tab-index vergeben werden. |
Access |
Access rights / Berechtigungen der Komponente:
|
Data layer |
Data layer der Datenbank-Tabelle, View oder einer Abfrage. |
Header / Footer |
|
Columns |
Anzahl der Spalten, in denen Formularfelder innerhalb der Komponente Data form platziert werden können. |
Label display |
Position der Formularfelder-Labels
Konfigurationen aller Formularfelder-Labels
|
Required mark |
Show required mark for required fields: Ausgeben eines definierten Zeichens: i.d.R. "*" deklariert Label als Pflichtfeld |
Optional mark |
Show optional mark for optional fields: Bei aktivierter Checkbox wird nach dem Label, das im Textfeld definierte Zeichen ausgegeben. Das definierte Zeichen oder Text, wird nach dem Label angezeigt. |
Validation |
Show validation summary: Alle durch Validierung ausgelöste Fehler oder Pflichtfelder werden bei aktiver Checkbox unter dem Formular ausgegeben |
2. Data Form Funktionalitäten
Events
Event (Form Object) |
Beschreibung |
---|---|
valueChanged |
Dieses Ereignis wird ausgelöst, wenn einer der Werte im Formular ohnehin geändert wurde. |
changedByUser |
Dieses Ereignis wird ausgelöst, wenn einer der Werte im Formular durch den Benutzer geändert wurde. |
Label display |
Dieses Ereignis wird ausgelöst, wenn die Eingabetaste in einem der Felder gedrückt wurde. |
Event (Form Item Objekt) |
Beschreibung |
---|---|
valueChanged |
Dieses Ereignis wird ausgelöst, wenn der Wert ohnehin geändert wurde. |
changedByUser |
Dieses Ereignis wird ausgelöst, wenn der Wert durch den Benutzer geändert wurde. |
Actions
Kategorisierung |
Action (Form Objekt) |
Beschreibung (GAPTEQ Designer) |
---|---|---|
State |
enable() |
Aktivieren Sie das Formular. |
disable() |
Deaktivieren Sie das Formular. (Formular ist nicht bearbeitbar) |
|
setEnabled(enabled) |
Aktivieren/Deaktivieren des Formulars. |
|
show() |
Zeigt das Formular an. |
|
hide() |
Blendet das Formular aus. |
|
setVisible(visible) |
Zeigt/verbirgt das Formular. |
|
readonly() |
Machen Sie das Formular schreibgeschützt. |
|
writeable() |
Machen Sie das Formular beschreibbar. |
|
setReadOnly(readOnly) |
Setzt das Formular auf schreibgeschützt/schreibbar. |
|
setFieldReadOnly(name, readOnly) |
Ein Feld schreibgeschützt einstellen. |
|
Appearance |
setTitle(title) |
Legen Sie den Titel des Formulars fest. |
setTitleText(title) |
Legen Sie den Titel des Formulars fest. |
|
setTitleHtml(title) |
Legen Sie den Titel des Formulars fest. |
|
setFooter(footer) |
Legen Sie die Fußzeile des Formulars fest. |
|
setFooterText(footer) |
Legen Sie die Fußzeile des Formulars fest. |
|
setFooterHtml(footer) |
Legen Sie die Fußzeile des Formulars fest. |
|
setFieldLabel(name, label) |
Legen Sie die Bezeichnung eines Feldes fest. |
|
Data |
updateFormat() |
Aktualisieren Sie das Format aller Formularfelder. |
clear() |
Alle Felder löschen. |
|
loadRow(key) |
Laden und Anzeigen einer Zeile (nur Lesen). |
|
findRow(key) |
Laden und Anzeigen einer Zeile (nur Lesen), wenn nicht gefunden, Anzeige einer leeren Zeile. |
|
editRow(key) |
Laden und Bearbeiten einer Zeile. |
|
newRow() |
Legen Sie eine neue Zeile zur Bearbeitung an. |
|
editOrNewRow(key) |
Laden und Bearbeiten einer Zeile, neue Zeile, wenn die Zeile nicht gefunden wurde. |
|
validate() |
Validieren Sie alle Formularfelder. |
|
saveEdit() |
Daten des Formulars speichern. |
|
cancelEdit() |
Bearbeitung abbrechen. |
|
User interaction |
focus() |
Legt den Fokus auf das Formular. |
Kategorisierung |
Action (Form Item Objekt) |
Beschreibung (GAPTEQ Designer) |
---|---|---|
State |
enable() |
Aktivieren Sie das Feld. |
disable() |
Disable the field. | |
setEnabled(enabled) |
Aktivieren/deaktivieren Sie das Feld. |
|
show() |
Zeigt das Feld an. |
|
hide() |
Blendet das Feld aus. |
|
setVisible(visible) |
Zeigt/verbirgt das Feld. |
|
writeable() |
Machen Sie das Feld beschreibbar. |
|
readonly() |
Machen Sie das Feld schreibgeschützt. |
|
setReadOnly(readOnly) |
Setzen Sie das Feld schreibgeschützt. |
|
Appearance |
setLabel(text) |
Legen Sie die Beschriftung des Feldes fest. |
Data |
refresh() |
Aktualisieren (nur Lookup, RadioGroup) |
clearValue() |
Löschen Sie den Wert. |
|
setValue(value) |
Legen Sie einen Wert fest. |
|
User interaction |
focus() |
Setzt den Fokus auf das Feld. |