Dropdown

The dropdown field captures a text or a list of texts. It has some “options”, i.e. possible values that are proposed in a dropdown menu.

This is the appropriate field for a compact rending of choices (as opposed to Single Choice or Multiple Choices fields), and when there are not too much options (see the Auto Complete field).

Preview

../../../_images/dropdown.png — The dropdown field proposes a list of choices to select in a menu.

Design

Definition

The standard properties apply:

Property	Definition
`Type`	The type of item (see above).
`Name`	The name of the item is not visible. It is a “variable” name that will be associated to the data collected. You will refer to this variable name when writing condition and/or validation scripts.
`Label`	The label is usually a question or a title.
`Description`	The description gives some guidance about how to enter data, what are their meaning etc.
`Required`	Whether an input is mandatory. Note that this does not apply when the visibility `Condition` is not satisfied.

The following dynamic properties apply:

Property	Definition
`Condition`	The condition makes an item visible or not, depending of other data. It is a small script which returns a logical value: `true` when item is visible. When no condition is specified (which is the default), the item is visible. See How to make fields conditional?
`Validation`	The validation specifies whether the data entry is correct. It is a small script which returns a logical value: `true` when item value is valid. Note that this validation script is not evaluated when the visibility `Condition` is not satisfied. See How to validate field values?
`Validation error message`	The validation error message to be displayed when validation fails.

Settings

Property	Definition
`Hint`	Help text below the input field.
`Default`	The default value. Only a single value can be specified, even when `Multiple choices` is set.
`Multiple choices`	When selected, the captured data is a list of texts. Default is `false`, i.e. a single value is captured.
`Options`	The list of predefined values, either to be selected or used as suggestions. For provisioning a lot of options, see How to make a select with a lot of options?

Style

Property	Definition
`Label class`	CSS class to apply to the field label. See How to style a form item?