Wiki-Quellcode von Variablenbereich


Verstecke letzte Bearbeiter
fse 7.1 1 {{figure image="designer_advanced_variables_example_de.png"}}
gru 1.1 2 Im Variablenbereich lassen sich versteckte Formularfelder anlegen. Diese können für Daten verwendet werden, die nicht im Formular sichtbar sein sollen und nur auf dem Server oder im JavaScript benötigt werden.
3 {{/figure}}
4
5 Im Variablenbereich des {{designer case="gen"/}} können zusätzliche Felder angelegt werden, die nie im Formular sichtbar sind. Grundsätzlich wird unterschieden zwischen Variablen, die nur serverseitig verfügbar sind, und Variable, die sowohl im Browser (Client) und auch auf dem Server zur Verfügung stehen.
6
7 Serverseitige Variablen können nur serverseitig gesetzt und gelesen werden, etwa durch Plugins oder durch die Statusverarbeitung. Mithin stehen serverseitige Variablen also nicht im JavaScript zur Verfügung.
8
9 Bei Variablen, die auch im Browser zur Verfügung stehen, werden im Formular versteckte Eingabefelder erzeugt: {{code language="none"}}<input type="hidden">{{/code}}
10
spe 8.1 11 Wie bei normalen Eingabefelder kann im Browser auf Variablen über ihren Namen zugegriffen werden. Um dem Formular mitzuteilen, dass der Wert per JavaScript geändert wurde, ist es notwendig, das "Change"-Ereignis auszulösen. Dies kann mit .trigger('change') erfolgen.
gru 1.1 12
spe 11.1 13 Beispiel: {{code language="none"}}$('[data-name="myAwesomeVar"]').val('test').trigger('change'){{/code}}
spe 8.1 14
15 Serverseitig werden Variablen über ihren Alias referenziert, der vom Namen abweichen kann. Über die Eigenschaft //Defaultwert// kann der Wert einer Variablen vorbelegt werden. Browserseitige Variablen können zusätzlich beim Formularaufruf durch URL-Parameter [[automatisch vorbelegt werden>>doc:Formcycle.Designer.Form.URLParameter]]. Der Übergabeparameter muss dabei dem Namen der Variablen entsprechen.
16
gru 1.1 17 Beim Anlegen von Variablen werden die folgenden Eigenschaften vergeben:
18
19 ; Nur Server
20 : Ob die Variable nur auf dem Server zur Verfügung stehen soll. Ansonsten ist sie auch im Browser als verstecktes Eingabenfeld verfügbar.und Serverseitig verfügbar.
21 ; Name
22 : Name zum Zugriff im Browser (clientseitig)
23 ; Alias
24 : Name zum Zugriff auf dem Server
25 ; Defaultwert
26 : Vorbelegung für den Wert (Initialer Wert)