DropDownListModel

actionFailureText String

Specifies the text to be displayed when a remote request fails.

Default: Error occurred in the request

allowFiltering Boolean

Specifies whether to allow the list of items to be filtered as input is entered into the search box.

Default: false

cssClass String

Specifies CSS classes to customize the appearance of the control.

Default: null

dataStore {:} DataStore String[]

Specifies a list of items that should be bound to the control either via a local object or a remote data source.

Default: []

enabled Boolean

Specifies whether the control is enabled or disabled, disabled will prevent user interaction.

Default: true

enableRtl Boolean

Specifies whether to render the control in right to left direction.

Default: false

enableState Boolean

Specifies whether to persist the state of the control between page loads.

Default: false

fields ItemSettingsModel

Specifies the property mapping for the data source columns to the items in the list.

Default: { }

filterBarPlaceholder String

Specifies a placeholder for the filter search text box.

Default: null

filterType FilterType

Specifies the type of filter to be used when filter the list items.

Default: StartsWith

footerTemplate Function

Specifies a template to customize the appearance of the footer that is visible below all list items in the popup.

Default: null

groupTemplate Function

Specifies a template to customize the appearance of the grouping headers.

Default: null

headerTemplate Function

Specifies a template to customize the appearance of the header that is visible above all list items in the popup.

Default: null

htmlAttributes {:}

Specifies additional HTML attributes, such as title, styles, class, id, and name, in a key-value pair format that will be appended to the HTML element. If both the property and equivalent HTML attributes are configured, then the control overrides the property value with the HTML attributes.

Default: {}

ignoreAccent Boolean

Specifies whether to ignore diacritic characters when filtering the list items.

Default: false

ignoreCase Boolean

Specifies whether to ignore the case, make case-sensitive, when filtering the list items.

Default: true

index Number

Specifies the selected item index.

Default: null

itemTemplate Function

Specifies a template to customize how the individual list items are displayed in the popup.

Default: null

labelType FloatingLabelType

Specifies the condition on when to show the floating label, for example: never, always.

Default: Never

locale String

Specifies the culture and localization value for this control, overriding the globally defined value.

Default: en-US

noRecordsText String

Specifies the text to be displayed when there are no records to be displayed.

Default: No records found

placeholder String

Specifies a short description of what is expected to be within the list of items.

Default: null

popupHeight String

Specifies the height of the popup expressed in pixels.

Default: 300px

popupWidth String

Specifies the width of the popup expressed in pixels. By default, the width of the popup is the width of the control. Value can be expressed in percent or pixels.

Default: 100%

query Query

Specifies a query that will be executed against the data source before the data source results are bound to the control.

Default: null

readonly Boolean

Specifies whether the control is readonly disabling all user interaction with the control.

Default: false

showClearButton Boolean

Specifies whether to show the clear button or not, allowing the user to clear the current value.

Default: false

text String

Gets or sets the display text of the current selected list item in the control.

Default: null

value String

Gets or sets the value of the current selected list item in the control.

Default: null

valueTemplate Function

Specifies a template to customize how the selected item will be displayed in the textbox element of the control.

Default: null

width String Number

Specifies the width of the control. By default, the width of the control is determined by its parent container. Value can be expressed in percent or pixels.

Default: 100%

zIndex Number

Specifies the zIndex of the popup.

Default: 1000

actionBegin EmitType<ActionBeginEventArgs>

Event callback that is raised before retrieving data from the data store.

actionComplete EmitType<ActionCompleteEventArgs>

Event callback that is raised after data has been retrieved from the data store.

actionFailure EmitType<Object>

Event callback that is raised when there is a failure in retrieving data from the data store.

beforeOpen EmitType<BeforeOpenEventArgs>

Event callback that is raised before the popup opens.

blur EmitType<Object>

Event callback that is raised when focus leaves the control.

change EmitType<ChangeEventArgs>

Event callback that is raised when the value has changed, either by a user selecting a value or by the value property being changed.

close EmitType<PopupEventArgs>

Event callback that is raised when the popup is closed.

created EmitType<CreatedEventArgs>

Event callback that is raised when the control has been created.

dataBound EmitType<DataBoundEventArgs>

Event callback that is raised when data has been bound to the control.

destroyed EmitType<Object>

Event callback that is raised when the control has been destroyed.

filtering EmitType<FilteringEventArgs>

Event callback that is raised when the list of items is filtered by typing in the textbox.

focus EmitType<FocusEventArgs>

Event callback that is raised when the control is focused.

open EmitType<PopupEventArgs>

Event callback that is raised when the popup is opened.

select EmitType<SelectEventArgs>

Event callback that is raised when an item in the popup list is selected, either by a mouse/tap event or navigating the list using the keyboard.