Function: a!dropdownFieldByIndex()
Displays a limited set of exclusive choices from which the user must select one item and saves the index of the selected choice. To save a value instead of the index, use a dropdown. This component is not available from the interface component picker in the design view.
Parameters
Name | Keyword | Type | Description |
---|---|---|---|
Label | label | Text | Optional text to display as the field label. |
Label Position | labelPosition | Text | Optional text to determine where the label appears. Valid values include
|
Instructions | instructions | Text | Optional text displayed below the dropdown. |
Help Tooltip | helpTooltip | 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 "COLLAPSED" . |
Choice Labels | choiceLabels | Text Array | List of options for the user to choose from. |
Placeholder Label | placeholderLabel | Text Array | Text to display at the top of the list. |
Selected Index | value | Integer | Value corresponding to the selected choice. |
Save Selection To | saveInto | Save Array | One or more variables that are updated with the choice value when the user changes the selection. Use a!save() to save a modified or alternative value to a variable. |
Required | required | Boolean | Determines if a value is required to submit the form. Default is false . |
Required Message | requiredMessage | Text | Custom message to be displayed when the field's value is required and not provided. |
Disabled | disabled | Boolean | Determines if the user is prevented from changing the value. Default is false . |
Validations | validations | Text Array | Validation errors to be displayed below the field when the value is not null. |
Validation Group | validationGroup | Text | When present, this field is only validated when a button in the same validation group is clicked. |
Visibility | showWhen | Boolean | Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
Notes
"ADJACENT"
or "ABOVE"
, but do not give a value for Label, a space still displays to the left-side or above, respectively, of the component as if there was a label displayed. To ensure the component appears to the far left when Label has no value, use "COLLAPSED"
for Label Position.On This Page