Grundeigenschaften - FORMCYCLE Wiki

author	version	line-number	content
1	Die Grundeigenschaften //Name//, //Breite// und //Versteckt// stehen jedem Formularelement zur Verfügung.
2
3	{{figure image="designer_properties_base_de.png"}}
4	In diesem Dialogfenster lassen sich grundlegende Eigenschaften wie Name oder Breite einstellen.
5	{{/figure}}
6
7	{{figure image="designer_properties_base_repeatable_elements_de.png"}}
8	Elemente können wiederholt werden, sodass der Nutzer eine beliebige Anzahl an Daten anlegen kann.
9	{{/figure}}
10
11	{{figure image="designer_properties_base_repeat_trigger_de.png"}}
12	Durch Auswahl eines Triggers für die Anzahl an Wiederholungen kann diese automatisch gesetzt werden. In diesem Beispiel wird das Fieldset für die Daten zum Kind wiederholt. Abhängig der gewählten Kinderzahl ist so immer die richtige Menge an Fieldsets sichtbar.
13	{{/figure}}
14
15	{{table dataTypeAlpha="0" fullwidth="false" colWidth="-500"}}
16	\|=Name\|=Beschreibung
17	\|Element\|{{version major="6" minor="3" /}}Elementtyp des Formularelements. Der Elementtyp kann durch Auswahl eines anderen Elementtyps aus dem Dropdown-Menü geändert werden. Die Elementtypen, in die ein Element umgewandelt werden kann, hängen dabei vom ursprünglichen Typ ab. [[Container>>doc:Formcycle.FormDesigner.FormElements.Container]] und [[Fieldsets>>doc:Formcycle.FormDesigner.FormElements.Fieldset]] können nur in den jeweils anderen Elementtyp transformiert werden. Alle anderen Elementtypen können in jeden anderen Typ transformiert werden, außer in Container und Fieldsets.
18	\|Name\|Name des Elements. Es sind nur Buchstaben und Zahlen erlaubt.
19	\|Alias\|Ein alternativer Name für das Formularelement, der alle Zeichen enthalten darf.
20	\|Breite\|Relative Breite des Elements zu anderen Elementen in einer Formularzeile. Sind etwa drei Elemente nebeneinander platziert und haben für die Breite die Werte //10//, //10// und //30// so nehmen sie in dieser Reihenfolge //20%//, //20%// und //60%// der gesamten Breite der Formularzeile ein.
21	\|Versteckt\|Ist hier ein Häkchen gesetzt, so wird das Element versteckt. Um es wieder anzuzeigen, kann die Eigenschaft [[sichtbar wenn>>doc:Constraints]] oder eine entsprechende JavaScript-Funktion wie {{jsdoc name="visible" page="jquery"/}} verwendet werden.
22	\|Gesperrt\|Der Inhalt des Formularelementes kann nicht editiert werden. Der Inhalt wird auch beim Absenden nicht übertragen. Für Textfelder kann zudem ausgewählt werden, ob der Inhalt beim Absenden übertragen wird oder nicht.
23	\|Wiederholen{{id name="repeat"/}}\|Ist diese Option aktiviert, so kann der Nutzer eine beliebige Anzahl an Wiederholunge (Kopien) von diesem Formularelement erstellen. Damit ist es etwa möglich, eine oder mehrere E-Mail-Adressen anzugeben. Es ist nicht möglich, wiederholte Elemente zu verschachteln: Ist ein Fieldset oder Container wiederholt, so kann kein Element darin mehr wiederholt werden.
24	\|Min. wdh.\|Mindestzahl an Wiederholungen, die vorhanden sein müssen. Eine wiederholtes Formularelement ist nicht löschbar, wenn dadurch diese Mindestzahl unterschritten werden würde. Die hier eingestellte Anzahl ist zudem auch anfangs sichtbare Anzahl an Wiederholungen (beim Aufrufs des Formulars).
25	\|Max. wdh.\|Höchstzahl an Wiederholungen, die erlaubt ist. Es kann keine weitere Kopie von einem Formularelement erzeugt werden, wenn dadurch diese Höchstzahl überschritten werden würde.
26	\|Element wdh.\|Falls hier ein Element ausgewählt ist, bestimmt der Wert des ausgewählten Elements (Trigger-Element) die Anzahl an Wiederholungen. Beispiel: Es wird ein [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection]] oder [[Eingabefeld>>doc:Formcycle.FormDesigner.FormElements.Input]] für die Anzahl der Kinder angelegt. Ein [[Fieldset>>doc:Formcycle.FormDesigner.FormElements.Fieldset]], wo die Daten zu einem Kind eingegeben werden, wird wiederholt. Die Anzahl der Wiederholungen wird aus dem Auswahlelement bzw. Eingabefeld genommen. Damit ist immer für jedes Kind ein Fieldset vorhanden.
27	\|Knöpfe verstecken\|{{version major="6" minor="2" /}} Nur verfügbar, falls unter //Element wdh.// ein Element ausgewählt ist. Mit dieser Option können die Plus- und Minusknöpfe zum Hinzufügen und Entfernen von Elementwiederholungen ausgeblendet werden. Dies ist dann sinnvoll, wenn die Anzahl der Wiederholungen nur über das ausgewählte Trigger-Element festgelegt werden soll.
28	{{/table}}
29
30	== Alias ==
31
32	Jedes Formular sendet Daten nach dem Prinzip //Elementname// {{rarrow/}} //Wert//. Diese Elementnamen können über die Platzhalterersetzung in Aktionen und Templates verwendet werden. In einigen Fällen kann es vorkommen, dass diese Namen nicht für die Weiterverarbeitung verwendet werden können. Das kann z.B. auftreten, wenn für die Weiterverarbeitung spezielle Zeichen verwendet werden müssen, die im Formulardesigner nicht zulässig sind. Für diesen Fall besteht die Möglichkeit, einen Alias zu vergeben.
33
34	Wurde ein Alias vergeben, wird nun statt dem Namen des Formularelements der Alias für die Verarbeitung in den Aktionen und bei der Platzhalterersetzung verwendet.

1

Die Grundeigenschaften //Name//, //Breite// und //Versteckt// stehen jedem Formularelement zur Verfügung.

2

3

4

In diesem Dialogfenster lassen sich grundlegende Eigenschaften wie Name oder Breite einstellen.

5

6

7

{{figure image="designer_properties_base_repeatable_elements_de.png"}}

8

Elemente können wiederholt werden, sodass der Nutzer eine beliebige Anzahl an Daten anlegen kann.

9

10

11

{{figure image="designer_properties_base_repeat_trigger_de.png"}}

12

Durch Auswahl eines Triggers für die Anzahl an Wiederholungen kann diese automatisch gesetzt werden. In diesem Beispiel wird das Fieldset für die Daten zum Kind wiederholt. Abhängig der gewählten Kinderzahl ist so immer die richtige Menge an Fieldsets sichtbar.

|=Name|=Beschreibung

|Element|{{version major="6" minor="3" /}}Elementtyp des Formularelements. Der Elementtyp kann durch Auswahl eines anderen Elementtyps aus dem Dropdown-Menü geändert werden. Die Elementtypen, in die ein Element umgewandelt werden kann, hängen dabei vom ursprünglichen Typ ab. [[Container>>doc:Formcycle.FormDesigner.FormElements.Container]] und [[Fieldsets>>doc:Formcycle.FormDesigner.FormElements.Fieldset]] können nur in den jeweils anderen Elementtyp transformiert werden. Alle anderen Elementtypen können in jeden anderen Typ transformiert werden, außer in Container und Fieldsets.

18

|Name|Name des Elements. Es sind nur Buchstaben und Zahlen erlaubt.

19

|Alias|Ein alternativer Name für das Formularelement, der alle Zeichen enthalten darf.

20

|Breite|Relative Breite des Elements zu anderen Elementen in einer Formularzeile. Sind etwa drei Elemente nebeneinander platziert und haben für die Breite die Werte //10//, //10// und //30// so nehmen sie in dieser Reihenfolge //20%//, //20%// und //60%// der gesamten Breite der Formularzeile ein.

21

|Versteckt|Ist hier ein Häkchen gesetzt, so wird das Element versteckt. Um es wieder anzuzeigen, kann die Eigenschaft [[sichtbar wenn>>doc:Constraints]] oder eine entsprechende JavaScript-Funktion wie {{jsdoc name="visible" page="jquery"/}} verwendet werden.

22

|Gesperrt|Der Inhalt des Formularelementes kann nicht editiert werden. Der Inhalt wird auch beim Absenden nicht übertragen. Für Textfelder kann zudem ausgewählt werden, ob der Inhalt beim Absenden übertragen wird oder nicht.

23

|Wiederholen{{id name="repeat"/}}|Ist diese Option aktiviert, so kann der Nutzer eine beliebige Anzahl an Wiederholunge (Kopien) von diesem Formularelement erstellen. Damit ist es etwa möglich, eine oder mehrere E-Mail-Adressen anzugeben. Es ist nicht möglich, wiederholte Elemente zu verschachteln: Ist ein Fieldset oder Container wiederholt, so kann kein Element darin mehr wiederholt werden.

24

|Min. wdh.|Mindestzahl an Wiederholungen, die vorhanden sein müssen. Eine wiederholtes Formularelement ist nicht löschbar, wenn dadurch diese Mindestzahl unterschritten werden würde. Die hier eingestellte Anzahl ist zudem auch anfangs sichtbare Anzahl an Wiederholungen (beim Aufrufs des Formulars).

25

|Max. wdh.|Höchstzahl an Wiederholungen, die erlaubt ist. Es kann keine weitere Kopie von einem Formularelement erzeugt werden, wenn dadurch diese Höchstzahl überschritten werden würde.

26

|Element wdh.|Falls hier ein Element ausgewählt ist, bestimmt der Wert des ausgewählten Elements (Trigger-Element) die Anzahl an Wiederholungen. Beispiel: Es wird ein [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection]] oder [[Eingabefeld>>doc:Formcycle.FormDesigner.FormElements.Input]] für die Anzahl der Kinder angelegt. Ein [[Fieldset>>doc:Formcycle.FormDesigner.FormElements.Fieldset]], wo die Daten zu einem Kind eingegeben werden, wird wiederholt. Die Anzahl der Wiederholungen wird aus dem Auswahlelement bzw. Eingabefeld genommen. Damit ist immer für jedes Kind ein Fieldset vorhanden.

27

|Knöpfe verstecken|{{version major="6" minor="2" /}} Nur verfügbar, falls unter //Element wdh.// ein Element ausgewählt ist. Mit dieser Option können die Plus- und Minusknöpfe zum Hinzufügen und Entfernen von Elementwiederholungen ausgeblendet werden. Dies ist dann sinnvoll, wenn die Anzahl der Wiederholungen nur über das ausgewählte Trigger-Element festgelegt werden soll.

== Alias ==

Jedes Formular sendet Daten nach dem Prinzip //Elementname// {{rarrow/}} //Wert//. Diese Elementnamen können über die Platzhalterersetzung in Aktionen und Templates verwendet werden. In einigen Fällen kann es vorkommen, dass diese Namen nicht für die Weiterverarbeitung verwendet werden können. Das kann z.B. auftreten, wenn für die Weiterverarbeitung spezielle Zeichen verwendet werden müssen, die im Formulardesigner nicht zulässig sind. Für diesen Fall besteht die Möglichkeit, einen Alias zu vergeben.

33

34

Wurde ein Alias vergeben, wird nun statt dem Namen des Formularelements der Alias für die Verarbeitung in den Aktionen und bei der Platzhalterersetzung verwendet.

Wiki-Quellcode von Grundeigenschaften

Navigation