RibbonComboBoxSettingsModel API in JavaScript Ribbon API control

Interface for a class RibbonComboBoxSettings

Properties

beforeOpen

EmitType<BeforeOpenEventArgs>

Event triggers before opening the popup.

change

EmitType<ChangeEventArgs>

Event triggers when an item in a popup is selected or when the model value is changed by user.

close

EmitType<PopupEventArgs>

Event triggers when the popup is closed.

created

EmitType<Event>

Event triggers once the combobox is created.

filtering

EmitType<FilteringEventArgs>

Event triggers on typing a character in the combobox.

open

EmitType<PopupEventArgs>

Event triggers when the popup is opened

select

EmitType<SelectEventArgs>

Event triggers when an item in the popup is selected.

allowFiltering

boolean

Specifies whether to show the filter bar (search box) of the combobox. The filter action retrieves matched items through the filtering event based on the characters typed in the search TextBox. If no match is found, the value of the noRecordsTemplate property will be displayed.

autofill

boolean

Specifies whether to suggest a first matched item in input when searching. No action happens when no matches found.

cssClass

string

Defines the CSS class to customize the appearance of the combobox.

dataSource

{ [key: string]: Object }[] | string[] | number[] | boolean[]

Defines the list of items to shown in the combobox.

fields

FieldSettingsModel

Specifies the mapping for the columns of the data table bind to the combobox.

• text - Maps the text column from data table for each list item.
• value - Maps the value column from data table for each list item.
• iconCss - Maps the icon class column from data table for each list item.
• groupBy - Group the list items with it’s related items by mapping groupBy field.

filterType

FilterType

Specifies filter type to be considered on search action. The FilterType and its supported data types are

footerTemplate

string | Function

Specifies the template content for the footer container of the popup list.

groupTemplate

string | Function

Specifies the template content for the group headers present in the popup list.

headerTemplate

string | Function

Specifies the template content for the header container of the popup list.

htmlAttributes

{ [key: string]: string }

Specifies additional HTML attributes to be applied to the combobox.

index

number

Specifies the index of the selected item in the combobox.

itemTemplate

string | Function

Specifies the template content for each list item present in the popup.

label

string

Specifies the label text for the overflow item.

noRecordsTemplate

string | Function

Specifies the template content for the popup list of combobox when no data is available.

placeholder

string

Specifies a short hint that describes the expected value of the combobox.

popupHeight

string | number

Specifies the height of the popup list.

popupWidth

string | number

Specifies the width of the popup list. By default, the popup width sets based on the width of the combobox.

showClearButton

boolean

Specifies whether to show or hide the clear button. When the clear button is clicked, value, text, and index properties are reset to null.

sortOrder

SortOrder

Specifies the order in which the data source needs to be sorted. The available type of sort orders are

• None - The data source is not sorted.
• Ascending - The data source is sorted in ascending order.
• Descending - The data source is sorted in descending order.

text

string

Defines the display text of the selected item in the combobox.

value

number | string | boolean

Defines the value of the selected item in the combobox.

width

string | number

Specifies the width of the combobox. By default, the combobox width sets based on the width of its parent container.