Wiki source code of Auswahl
Show last authors
author | version | line-number | content |
---|---|---|---|
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"/}} |