Forms 2.0 - Dropdown
caution
This page is preliminary and subject to change as Forms 2.0 continues to be developed.
Allows users to select a value from a list.
Adding a Dropdown
Drag the Dropdown tile from the field palette onto the Canvas - see Build for more on adding and arranging fields in general.
Parameters
Only Dropdown-specific parameters are listed below. See Common Field Settings for the settings shared with other field types.
| Field | Description |
|---|---|
| Text When No Selection | Text shown as a "please select" placeholder option, listed first in the dropdown. Supports Tokens. |
| Data Source | Where the dropdown's list of options comes from - see Data Source on the Common Field Settings page. |
| Refresh Data | When enabled, unlocks When Fields Change below, so the data source can refresh automatically. |
| When Fields Change | Only shown when Refresh Data is enabled. One or more trigger fields; when their values change, this field's data source refreshes using the updated values. |
| Initially Selected | Which item is selected by default, matching one of the list's values. If an "Other" Option is configured, a value that isn't one of the items selects that option instead (its own text leaves the textbox empty; any other value pre-fills it). Supports Tokens. |
| "Other" Option | Optionally adds an extra option that, when selected, shows a textbox for the user to type their own value (the submitted value is what the user typed, not this option's text). Supports Tokens. |
| Root CSS Classes | One or more CSS class names, separated by spaces, applied to the field's root element only. Supports Tokens. |
| Custom Attributes | Name/value pairs inserted as HTML attributes on the field's <select> tag, for use by JavaScript or CSS. Supports Tokens. |
Common settings that apply to Dropdown
A Dropdown supports these Common Field Settings:
- General (Label, Name, and Hint)
- Active
- Visibility settings
- Enabled settings
- Field Automations - Value and On Change (Dropdown does not support On Click)
- Field Validators
- Data Source
Tokens
A Dropdown returns several tokens about the selected item, referenced using the field's Name - for example, if the field's Name is Country:
| Token | Description |
|---|---|
[Country] | The selected item itself. |
[Country:Text] | The selected item's display text. |
[Country:Value] | The selected item's underlying value. |
[Country:Path] | The selected item's path (relevant for hierarchical data sources). |