Dropdown List
A component that combines an editable field and a drop-down list. The user can select a value from the drop-down list. If you make the combo box editable, then the combo box includes an editable field into which the user can type a value. |  |
Public Variables (Properties)
[?]
The Dropdown List component has the following properties and property groups that are common to all components:
Name, Advanced Properties, Dropdown Style, Container Properties, Styles, Preloader, Events, Bindings.
Placeholder
The text displays when there is no other text in the input field.
Variable Name: | placeholder |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
placeholder | String | Placeholder |
Select Size
Defines the component size. This property has afew selection values:
Small Size
Default Size
Large Size
Variable Name: | selectSize |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
selectSize | String | Select Size |
Confirmation Required
If enabled, displays the confirmation window after initial selection.
Variable Name: | confirmationRequred |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
confirmationRequred | Boolean | Confirmation Required |
Confirmation Message
Defines the confirmation message text.
Variable Name: | confirmationMessage |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
confirmationMessage | String | Confirmation Message |
Multiple Selection
If enabled, allows multiple selections in the dropdown list.
Variable Name: | multi |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
multi | Boolean | Multiple Selection |
Maximum Tag Count
Defines maximum number of tags to display.
Variable Name: | maxTagCount |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
maxTagCount | Integer | Maximum Tag Count |
The text of additional tag that displays when the value of Maximum Tag Count property is exceeded.
Variable Name: | maxTagPlaceholder |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
maxTagPlaceholder | String | Placeholder for Hidden Tags |
Searchable
If enabled, allows searching input text by dropdown list elements.
Variable Name: | searchable |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
searchable | Boolean | Searchable |
Editable
If enabled, the dropdown menu will include a text box which allows the user to enter a custom value.
Variable Name: | editableOption |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
editableOption | Boolean | Editable |
Options
This property defines the set of selection values in the dropdown list.
Variable Name: | options |
Records: | 0..unlimited |
Record Format:
Field Name | Field Type | Field Description |
value | String | Value. The unique value of the element. Commonly used to access a particular element using bindings. |
label | String | Label. The element description text to display in the dropdown list. |
tooltip | String | Tooltip. The element tooltip text. |
Selected Items
This property defines the single selection value or set of values selected by default.
Variable Name: | currentOptions |
Records: | 0..unlimited |
Record Format:
Field Name | Field Type | Field Description |
value | String | Value. The unique value of the element. Commonly used to access a particular element using bindings. |
label | String | Label. The selection value displayed text. |
tooltip | String | Tooltip. The selection value tooltip text. |
Always Show Placeholder
If enabled, the placeholder will be always displayed regardless of the presence of text.
Variable Name: | alwaysShowPlaceholder |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
alwaysShowPlaceholder | Boolean | Always Show Placeholder |
Allow Clearing
This flag defines if the input field may be cleared.
Variable Name: | allowClear |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
allowClear | String | Allow Clearing |
Show Arrow
This flag defines if the arrow icon inside the input field will be displayed.
Variable Name: | showArrow |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
showArrow | Boolean | Show Arrow |
Disabled
This flag indicates the component is active. Disabled components do not respond to user input, and are rendered as grayed-out.
Variable Name: | disabled |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
disabled | Boolean | Disabled |
Dropdown Horizontal Offset
Controls the horizontal offset in pixels between the textbox and the window containing the menu options. Used in conjunction with the Dropdown Layout property. When the value of Dropdown Layout includes the word Left, the Dropdown Horizontal Offset value will be applied to shift the menu window to the left by the indicated number of pixels. The opposite will occur if the value of Dropdown Layout includes the word Right.
Variable Name: | dropdownOffsetX |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
dropdownOffsetX | Integer | Dropdown Horizontal Offset |
Dropdown Vertical Offset
Controls the vertical offset in pixels between the textbox and the window containing the menu options. Used in cnjunction with the Dropdown Layout property. When the value of Dropdown Layout includes the word Top the Dropdown Vertical Offset value will be applied to shift the menu window up by the indicated number of pixels. The opposite will occur if the value of Dropdown Layout includes the word Bottom.
Variable Name: | dropdownOffsetY |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
dropdownOffsetY | Integer | Dropdown Vertical Offset |
Dropdown Layout
Controls how the Dropdown Horizontal Offset and Dropdown Vertical Offset properties are applied to the dropdown menu window relative to the textbox. The following options are available:
Bottom Left - The dropdown menu will be offset down and to the left relative to the textbox.
Bottom Right - The dropdown menu will be offset down and to the right relative to the textbox.
Top Left - The dropdown menu will be offset up and to the left relative to the textbox.
Top Right - The dropdown menu will be offset up and to the right relative to the textbox.
Variable Name: | dropdownLayout |
Records: | 1 |
Record Format:
Field Name | Field Type | Field Description |
dropdownLayout | String | Dropdown Layout |
Public Events
[?]
Common Events: Input Changed
Was this page helpful?