Wiki source code of Auswahl


Show last authors
1 {{panel float="right"}}
2 (% class="block text-align-center%){{ficon name="XSelect" size="4em"/}}
3
4 (% class="block%)The icon for elements of type //selection//.
5 {{/panel}}
6
7 == Functionality ==
8
9 {{figure image="designer_element_select_views_de.png" width="400"}}
10 Possible layouts of a selection element.
11 {{/figure}}
12
13 Form elements of type //selection// add a selection with multiple options to the current form. The [[property panel label>>doc:Formcycle.Designer.Form.ElementProperties.Label]] allows you to add a descriptive label to the form field.
14
15 A selection can be displayed in different ways:
16
17 * as a combobox
18 * as a drop down list
19 * as a list of checkboxes
20 * as a list of radio buttons
21 * as questions with checkboxes (useful for surveys)
22 * as questions with radio buttons (useful for surveys)
23
24 The layout can be set on the basic property panel of the {{designer/}}.
25
26 If a selection is shown as a combobox and it is not a required field, the first option is selected by default. When it it is a required field, no option will be selected initially and the text //Please select// is displayed.
27
28 {{internBaseOptionsElement page="base"/}}
29
30 {{internBaseOptionsElement page="style"}}
31 {{figure image="designer_element_select_properties_basic_de.png"}}
32 Additional display properties for a selection element.
33 {{/figure}}
34
35 {{table dataTypeAlpha="0" colWidth="-500"}}
36 |=Name|=Description
37 |Layout|Changes the layout how the options are displayed.
38 |Alignment|Changes the text alignment (left, right, up, down) of the element's text. Not available for comboboxes or lists.
39 |Column width|The width of each option in pixels. Only available for the horizontal display modes //checkboxes// and //radio buttons//.
40 |Autocomplete|Available only if the layout is //combobox//. When this option is activated, the select element is shown as a text input field. As the users is entering text, they are offered a list of possible options.
41 |Allow free text {{version major="7" minor="2"/}}|Available only when //Autocomplete// is enabled. Allows the user to enter any value, even if no option corresponding to that value exists.
42 {{/table}}
43 {{/internBaseOptionsElement}}
44
45 {{internBaseOptionsElement page="cond"}}
46 {{figure image="designer_element_select_properties_constraints_de.png"}}
47 Constraints for a selection element.
48 {{/figure}}
49
50 {{table dataTypeAlpha="0" colWidth="-500"}}
51 |=Name|=Beschreibung
52 |Min. selection|Specifies the minimum number of options that must be selected.
53 |Max. selection|Specifies the maximum number of options that can be selected. Set this to {{code}}0{{/code}} to allow any number of options.
54 {{/table}}
55 {{/internBaseOptionsElement}}
56
57 {{internBaseOptionsElement page="label"/}}
58
59 == Options ==
60
61 {{id name="sec-options"/}}
62
63 {{figure image="designer_element_select_properties_options_de.png"}}
64 New properties section //options// for select elements.
65 {{/figure}}
66
67 {{table dataTypeAlpha="0" preSort="0-asc" colWidth="-500"}}
68 |=Name|=Description
69 |Data sources|The data source for retrieving the options of this selection form field. When set to //user-defined//, you can enter the options manually. You can use [[CSV>>doc:Formcycle.UserInterface.Data.Sources]] and [[DB Queries>>doc:Formcycle.UserInterface.Data.DBQueries]] as data sources. When a database source is selected and the database cannot be reached, the manually entered options are shown instead.
70 {{/table}}
71
72 {{internBaseOptionsElement page="val"/}}
73
74 {{internBaseOptionsElement page="css"/}}
75
76 {{internBaseOptionsElement page="help"/}}
77
78 {{internBaseOptionsElement page="attr"/}}
79
80 {{internBaseOptionsElement page="avail"/}}
81
82 {{internBaseOptionsElement page="ronly"/}}
83
84 {{internBaseOptionsElement page="misc"/}}
85
86
87 {{content moveToTop="true"/}}