| ... |
... |
@@ -15,7 +15,7 @@ |
| 15 |
15 |
{{table dataTypeAlpha="0" fullwidth="false" colWidth="-500"}} |
| 16 |
16 |
|=Name|=Beschreibung |
| 17 |
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. |
|
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 |
19 |
|Alias|Ein alternativer Name für das Formularelement, der alle Zeichen enthalten darf. |
| 20 |
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 |
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. |
| ... |
... |
@@ -34,6 +34,20 @@ |
| 34 |
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 |
35 |
|
| 36 |
36 |
{{id name="form_element_refactoring"/}} |
|
37 |
+ |
| 37 |
37 |
== Umbenennen von Formularelementen == |
| 38 |
38 |
|
| 39 |
|
-Mit einem Klick auf das Stiftsymbol {{icon name="pencil"/}} kann das Formularelement umbenannt werden, wobei zugleich sämtliche Referenzen auf das Formularelement aktualisiert werden. |
|
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. |
