Wiki-Quellcode von Grundeigenschaften

Zeige letzte Bearbeiter
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|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.Designer.Form.FormElements.Container]] und [[Fieldsets>>doc:Formcycle.Designer.Form.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. Um den Namen zu ändern und gleichzeitig die Referenzen auf dieses Formularelement zu aktualisieren sollte die Funktion zum [[Umbenennen von Formularelementen>>||anchor=form_element_refactoring]] {{icon name="pencil" /}} verwendet werden.
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.Designer.Form.FormElements.Selection]] oder [[Eingabefeld>>doc:Formcycle.Designer.Form.FormElements.Input]] für die Anzahl der Kinder angelegt. Ein [[Fieldset>>doc:Formcycle.Designer.Form.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|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.
35
36 {{id name="form_element_refactoring"/}}
37
38 == Umbenennen von Formularelementen ==
39
40 Werden Formularelemente ganz einfach umbenannt, funktionieren möglicherweise Teile des JavaScript oder der Verarbeitung nicht mehr korrekt, da diese das Formularelement über dessen Namen referenzieren. Mit einem Klick auf das Stiftsymbol {{icon name="pencil"/}} neben dem Formularelementnamen kann das Formularelement umbenannt werden, wobei zugleich sämtliche Referenzen auf das Formularelement aktualisiert werden. Es kann ausgewählt werden, an welchen Stellen nach Referenzen auf das Formularelement gesucht werden soll:
41
42 * im JavaScript-Bereich des Formulars
43 * im CSS-Bereich des Formulars
44 * in JavaScript-Formulardateien
45 * in CSS-Formulardateien
46 * in der Verarbeitung des Formulars
47 * bei Elementen auf die Eigenschaft "Wert"
48 * bei Elementen auf die Eigenschaft "Schaltflächen"
49 * bei Elementen auf die Eigenschaft "Optionen"
50
51 Wird eine Referenz in den ausgewählten Bereichen gefunden, wird diese mit dem neuen Namen aktualisiert.
52
53 Im JavaScript-Bereich ist darauf zu achten, dass nur übliche Arten behandelt werden, auf ein Formularelement zu referenzieren. In Selektoren wie //$('[name="tfEmail"]')// wird der Name entsprechend angepasst. Unübliche Selektoren wie //document.getElementByName("tfEmail")// werden nicht angepasst. Weiterhin ist es prinzipiell unmöglich, alle in einer Programmiersprache möglichen Referenzen anzupassen, beispielsweise wenn der Name aus Variablen, Berechnungen oder externen Datenquellen bezogen wird: //["EMail", "Vorname", "Nachname"].forEach(name => $(`[name="tf${name}"]`).clear())// Daher sollte bei Formular mit komplexen JavaScript immer manuell geprüft werden, welche Auswirkungen eine Umbennenung eines Formularelements hat.