a!dropdownFieldByIndex( label, labelPosition, instructions, required, disabled, choiceLabels, placeholder, value, validations, saveInto, validationGroup, requiredMessage, helpTooltip, accessibilityText, showWhen, searchDisplay )
Displays a list of choices for the user to select one item and saves the index of the selected choice. To save a value instead of the index, use a dropdown component.
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text to display as the field label. |
Label Position |
|
Text |
Determines where the label appears. Valid values:
|
Instructions |
|
Text |
Supplemental text about this field. |
Required |
|
Boolean |
Determines if a value is required to submit the form. Default: false.' |
Disabled |
|
Boolean |
Determines if the field should display as potentially editable but grayed out. Default: false.' |
Choice Labels |
|
List of Text String |
Array of options for the user to select. |
Placeholder |
|
Text |
Text to display when nothing is selected and the value is null. |
Selected Index |
|
Number (Integer) |
Index of the choice to display as selected. |
Validations |
|
List of Text String |
Validation errors to display below the field when the value is not null. |
Save Selection To |
|
List of Save |
One or more variables that are updated with the choice index when the user changes the selection. Use a!save() to save a modified or alternative value to a variable. |
Validation Group |
|
Text |
When present, the requiredness of the field is only evaluated when a button in the same validation group is pressed. The value for this parameter cannot contain spaces. For example, |
Required Message |
|
Text |
Custom message to display when the field's value is required and not provided. |
Help Tooltip |
|
Text |
Displays a help icon with the specified text as a tooltip. The tooltip displays a maximum of 500 characters. The help icon does not show when the label position is |
Accessibility Text |
|
Text |
Additional text to be announced by screen readers. Used only for accessibility; produces no visible change. |
Visibility |
|
Boolean |
Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
Search Display |
|
Text |
Determines when a search box displays above the options. Valid values: |
null
and not an index.Dropdown by Index with Initial Value
Use the interactive editor below to test out your code:
Feature | Compatibility | Note |
---|---|---|
Portals | Compatible | |
Offline Mobile | Compatible | |
Sync-Time Custom Record Fields | Incompatible | |
Real-Time Custom Record Fields | Incompatible | Custom record fields that evaluate in real time must be configured using one or more Custom Field functions. |
Process Reports | Incompatible | Cannot be used to configure a process report. |
Process Events | Incompatible | Cannot be used to configure a process event node, such as a start event or timer event. |
There are older versions of this interface component. You can identify older versions by looking at the name to see if there is a version suffix. If you are using an old version, be sure to refer to the corresponding documentation from the list below.
Old Versions | Reason for Update |
---|---|
a!dropdownFieldByIndex_20r2 | Added an optional search box and renamed the placeholderLabel parameter to placeholder. |
To learn more about how Appian handles this kind of versioning, see the Function and Component Versions page.
Dropdown By Index Component