Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.gru
	1	+XWiki.fse

Content

...	...	@@ -1,8 +1,10 @@
1		-The constraints panel contains options to check the value of form fields, when form fields should be visible and when they can be edited. Some constraints are available only for some element, see the [[list of element.>>doc:Main.Elemente]].
	1	+The constraints panel contains options to check the value of form fields, when form fields should be visible and when they can be edited. Some constraints are available only for some element, see the [[list of element.>>doc:Formcycle.FormDesigner.FormElements.WebHome]].
2	2
3	3	== Properties ==
4	4
5		-{{figure image="Bedingungen_en.png"}}A form field can be made a required field, requiring the user to enter something or select an option.{{/figure}}
	5	+{{figure image="designer_properties_constraints_en.png"}}
	6	+A form field can be made a required field, requiring the user to enter something or select an option.
	7	+{{/figure}}
6	6
7	7	{{table dataTypeAlpha="0" colWidth="-500"}}
8	8	|=Name|=Description
...	...	@@ -10,6 +10,7 @@
10	10	|visible if|Makes a form field that has been hidden visible again, when a certain condition is satisfied.
11	11	|read-only if|Locks a form field and disallows any input, when a certain condition is satisfied.
12	12	|editable if|Make a form field that has been set to read-only editable again, when a certain condition is satisfied.
	15	+|required|When this option is activated, a value must be entered for the form field. Conditions set under //required if// are ignored when this option is activated.
13	13	|required if|Marks a form field as a required field, when a certain condition is satisfied.
14	14	|required group|Available only when the form field is a required field. Specifies the required group the form field should belong to. When two or more form fields belong to the same group, at least one of these form fields needs to be filled out, all other fields may remain empty.
15	15	{{/table}}
...	...	@@ -16,14 +16,14 @@
16	16
17	17	== Condition ==
18	18
19		-{{figure image="007En.png"}}
20		-Any condition referring to the value of a [[form element of type selection>>doc:Main.Auswahl]] uses the value of the option for testing the condition, that has been given to that option in the column //value// in the
21		-//values// properties panel of the {{designer/}}.
	22	+{{figure image="designer_element_select_properties_options_en.png"}}
	23	+Any condition referring to the value of a [[select element>>doc:Formcycle.FormDesigner.FormElements.Selection]] uses the value of the option for testing the condition, as entered in the colum //value//.
22	22	{{/figure}}
23	23
24	24	You can change a form field's visibility and read-only state depending on the value of another form element. The following conditions are available for the options //hidden if//, //visible if//, //read-only if//, //editable if//, and //required if//:
25	25
26	26	* has a value
	29	+* has no value
27	27	* equals
28	28	* not equals
29	29	* lower than
...	...	@@ -39,25 +39,25 @@
39	39
40	40	{{table}}
41	41	|=Condition|=Description
42		-|has a value|(((The conditions evaluates to //true// when the value of the form field is not empty.
	45	+|has a value / has no value|(((The conditions evaluates to //true// when the value of the form field is (not) empty.
43	43
44	44	In particular, //having a value// mean the following for different form elements:
45	45
46		-* for a [[checkbox>>doc:Checkbox]], that the checkbox is not checked.
47		-* for a [[selection>>doc:Auswahl]], that some option other than //Please select an option// has been selected. When the selection field is displayed as a combo box, the first option will be selected by default, unless the selection is a required field, in which case the option //Please select an option// will be selected by default.
48		-* for an [[input field>>doc:Eingabefeld]], that at least one character has been entered.)))
	49	+* for a [[checkbox>>doc:Formcycle.FormDesigner.FormElements.Checkbox]], that the checkbox is not checked.
	50	+* for a [[selection>>doc:Formcycle.FormDesigner.FormElements.Selection]], that some option other than //Please select an option// has been selected. When the selection field is displayed as a combo box, the first option will be selected by default, unless the selection is a required field, in which case the option //Please select an option// will be selected by default.
	51	+* for an [[input field>>doc:Formcycle.FormDesigner.FormElements.Input]], that at least one character has been entered.)))
49	49	|equals|The condition evaluates to //true// when the value of the form field equals the given value. Comparisons are case-sensitive.
50		-|unequal|The condition evaluates to //true// when the value of the form field does not equal the given value. Comparisons are case-sensitive.
	53	+|not equals|The condition evaluates to //true// when the value of the form field does not equal the given value. Comparisons are case-sensitive.
51	51	|lower than / lower or equal than|The condition evaluates to //true// when the value is lower (or equal) than the specified value.
52	52	|greater than / greater or equal than|The condition evaluates to //true// when the value is greater (or equal) than the specified value.
53		-|between|The condition evaluates to //true// when the value is between the specified range, inclusively. The interval must be entered with a dash (-), for example //2-10//. Negative numbers must be enclosed in parentheses, eg. //(-10) - (- 5)//.
	56	+|between|The condition evaluates to //true// when the value is between the specified range, inclusively. The interval must be entered with a dash ({{{-}}}), for example //2-10//. Negative numbers must be enclosed in parentheses, eg. //(-10) - (- 5)//.
54	54	|regexp|The condition evaluates to //true// when the value matches the specified regexp.
55	55	{{/table}}
56	56
57		-== Empty automatically ==
	60	+== Clear or reset automatically ==
58	58
59		-For the properties //hidden if// and //read-only if//, you may choose whether the form field should be emptied automatically when it gets hidden or locked.
	62	+For the properties //hidden if// and //read-only if//, you may choose whether the form field should be cleared or reset automatically when the form field ist hidden or disabled. Clearing a form field means that its value is removed, eg. deleting the entered text for an input field or unchecking all checkboxes for a select field. Resetting a form field, on the other hand, refers to changing its value back to the original or initial value it had when the form was openend. In case the form was opened for the first time and not submitted yet, the original value is the value as set in the {{designer/}}. Otherwise, when the form was already submitted and is opened in the inbox, the original value is the most recently submitted (saved) value.
60	60
61	61	For example, consider the case of entering an address. The user can choose between a physical address and a post-office box, and only one input field is visible depending on the user's choice. When the form is submitted, a value should be send only for one of both fields. By selecting the //empty automatically// options, the input field //post-office box// will be cleared automatically when the user selects a physical address.
62	62
63		-When emptying an element, all sub elements will be emptied as well. This applies to form elements of type [[page>>doc:Seite]], [[container>>doc:Container]], and [[fieldset>>doc:Fieldset]].
	66	+When an element is cleared or reset, all the elements it contains are cleared or reset as well. This applies to form elements of type [[page>>doc:Formcycle.FormDesigner.FormElements.Page]], [[container>>doc:Formcycle.FormDesigner.FormElements.Container]], and [[fieldset>>doc:Formcycle.FormDesigner.FormElements.Fieldset]].