Änderungen von Dokument Widget-Plugin: Berechnungselement


Von Version 7.3
bearbeitet von awa
am 03.08.2022, 20:08
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 11.1
bearbeitet von rpe
am 16.02.2023, 16:05
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.awa
1 +XWiki.rpe
Inhalt
... ... @@ -62,6 +62,7 @@
62 62  |=Name|=Beschreibung
63 63  |Berechnungsfeld|In dieses nicht mit einem Label benannte Feld kann ein Berechnungsformel eingegeben werden, welche bei jeder Wertänderung von einem der in der Berechnungsformel verwendeten Eingabelemente erneut ausgeführt wird.
64 64  Als Syntax wird //JavaScript// verwendet. Für das Ermitteln der zu verwendenden Werte von anderen Eingabelementen können neben //jQuery//-Selektoren auch {{formcycle/}} [[Platzhalter>>doc:Formcycle.UserInterface.Variables]] verwendet werden.
65 +|Feldwerte|Hier kann ausgewählt werden, mit welchem Datentypen die Feldwerte behandelt werden sollen. Entwerder soll für jeden Feldwert automatisch ermittelt, welcher Datentyp der er hat oder es sollen alle Feldwerte als Text gelesen werden. Letzteres ist zum Verketten von Strings sinnvoll. Jedoch sind damit Berechnungen (z.B. [%tf1%] - [%tf2%]) ausgeschlossen.
65 65  |Leere Felder|Hier kann ausgewählt werden, was passieren soll, wenn ein Formularelement keinen Wert hat. Entweder wird es wie die Zahl 0 behandlelt oder wie leerer Text. Bei nummerischen Berechnungen sollte der Wert in der Regel wie die Zahl 0 behandelt werden.
66 66  |Reihenfolge Index|Diese Option ist nur in Ausnahmefällen notwendig. Standardmäßig werden die Felder automatisch in der Reihenfolge abgearbeitet, wie es die Formeln vorgeben. Falls die automatisch erkannte Reihenfolge einmal nicht korrekt sein sollte, kann eine Indexzahl vergeben werden. Wenn in wenigstens einem Formelfeld ein Index gesetzt ist, ist die Reihenfolge der Abarbeitung wie folgt: Zuerst werden alle Berechnungenfelder mit einem Index abgearbeitet, wobei vom niedrigsten Indexwert zum größten Indexwert vorgegangen wird. Anschließend werden alle Berechnungen ohne einen Index ausgeführt, entsprechend den normalen Regeln (von oben nach unten und von links nach rechts).
67 67  {{/table}}
... ... @@ -91,7 +91,7 @@
91 91  $('[name=tf1]').val() - $('[name=tf2]').val(){{/code}}|Subtraktion der Werte in den Eingabefeldern //tf1// und //tf2// einmal unter Verwendung von Passwörtern und einmal mittels //jQuery//-Selektoren
92 92  |{{code language="none"}}[%tf2%] * (1 + ([%tf1%] / 100)){{/code}}|Wird in //tf1// z.B. der Steuersatz und in //tf2// der Nettobetrag eingegeben, wird der Bruttobetrag berechnet
93 93  |{{code language="none"}}[%tf1%] + " " + [%tf2%]{{/code}}|Stringverkettung aus den Eingaben in den Eingabefeldern //tf1// und //tf2//
94 -|{{code language="none"}}[%tf1%].length(){{/code}}|Anzahl der eigegebenen Zeichen im EIngabefeld //tf1//
95 +|{{code language="none"}}[%tf1%].length{{/code}}|Anzahl der eigegebenen Zeichen im Eingabefeld //tf1//
95 95  |{{code language="none"}}([%tf1%]<2) ? "Genehmigt" : "Abgelehnt"{{/code}}|Wenn der Wert in //tf1// kleiner als 2 ist, soll "Genehmigt" ausgegeben werden. Ansonsten "Abgelehnt".
96 96  |{{code language="none"}}$('[org_name=tf1]').sum()
97 97  
... ... @@ -99,7 +99,7 @@
99 99  (neue Schreibweise bei W3C konformen Modus)|Beispiel für Berechnen der Summe von wiederholten Elementen mit dem Namen //tf1//. Für wiederholte Elemente und Elemente innerhalb von wiederholten Containern und Fieldsets muss ein normaler JavaScript-Selektor oder wie in diesem Beispiel ein //jQuery//-Selektor verwendet werden.
100 100  {{/table}}
101 101  
102 -Ein Demo-Beispiel zu den erwähnten Möglichkeiten finden Sie [[hier>>https://demo2.formcycle.eu/formcycle/form/provide/653/||rel="noopener noreferrer" target="_blank"]].
103 +Ein Demo-Beispiel zu den erwähnten Möglichkeiten finden Sie [[hier>>https://formexchange.formcycle.eu/formcycle/form/alias/104/widget_formula||rel="noopener noreferrer" target="_blank"]].
103 103  
104 104  == Mögliche CSS-Anpassungen ==
105 105  
... ... @@ -119,6 +119,23 @@
119 119  
120 120  == Versionshistorie ==
121 121  
123 +=== 2.3.0 ===
124 +
125 +* Feature: Es kann nun ausgewählt werden, ob die Datentypen der Feldwerte automatisch ermittelt werden sollen oder ob die Feldwerte immer als Text gelesen werden sollen. Bisher wurden sie immer automatisch ermittelt.
126 +
127 +=== 2.2.1 ===
128 +
129 +* Verbesserung der Performance beim Auswerten der Formeln.
130 +
131 +=== 2.2.0 ===
132 +
133 +* Erfordert mindestens {{formcycle/}} Version 7.2.0.
134 +* Auch nicht Formel-Platzhalter in der Formel werden ersetzt
135 +* Das Eingabfeld für die Formel passt sich in der Höhe automatisch seinem Inhalt an.
136 +* Das Eingabfeld für die Formel erlaubt die Eingabe von Zeilenumbrüchen.
137 +* Bei Änderungen des Werts eines Formelfelds wird das JQuery-Ereignis //change// ausgelöst.
138 +* Der this-Kontext innerhalb des Formel-JavaScript-Ausdrucks wird nun auf die JQuery-Instanz des Formelfelds gesetzt, dessen Formel evaluiert wird.
139 +
122 122  === 2.1.1 ===
123 123  
124 124  * Fix: Formeln, welche von einem Element abhängen, welches über eine Bedingung versteckt oder gesperrt geschalten und geleert wird, aktualisieren sich, wenn die abängigen Elemente geleert werden.
... ... @@ -125,7 +125,7 @@
125 125  
126 126  === 2.1.0 ===
127 127  
128 -* Validationsattribute wie etwa Pflichtfeld, maximaler Wert und minimaler Wert sind nun auch am Berechnungsfeld verfügbar. Damit kann etwa einfach geprüft werden, ob die Summe von Elementen einen bestimmten Wert nicht überschreitet.
146 +* Feature: Validationsattribute wie etwa Pflichtfeld, maximaler Wert und minimaler Wert sind nun auch am Berechnungsfeld verfügbar. Damit kann etwa einfach geprüft werden, ob die Summe von Elementen einen bestimmten Wert nicht überschreitet.
129 129  
130 130  === 2.0.9 ===
131 131