MultiColumnComboBox

Directive

kendo-multicolumncombobox

Child Components

Props

animation Object

Configures the opening and closing animations of the suggestion popup (animation in Kendo UI for jQuery). Setting the animation option to false disables the opening and closing animations. As a result, the suggestion popup will open and close instantly. The supported composite props are available in AnimationProps.

auto-bind Boolean

Defines whether to bind the widget to the data source upon its initialization (autoBind in Kendo UI for jQuery).

cascade-from String

Sets the id of the parent MultiColumnComboBox (cascadeFrom in Kendo UI for jQuery).

cascade-from-field String

Defines the field for filtering the data source (cascadeFromField in Kendo UI for jQuery). If cascade-from-field is not defined, the parent dataValueField option will be used.

cascade-from-parent-field String

Defines the parent field for retaining the from value (cascadeFromParentField in Kendo UI for jQuery). The value will also be used to filter the data source. If cascade-from-parent-field is not defined, the value from the parent dataValueField will be used.

columns Array

Defines the columns which are rendered in the table of the MultiColumnComboBox (columns in Kendo UI for jQuery).

clear-button Boolean

If clear-button is set to true, the MultiColumnComboBox renders a button on hover over the widget (clearButton in Kendo UI for jQuery). Clicking that button resets the value of the AutoComplete and triggers the change event.

data-source Object | Array | kendo.data.DataSource

The data source of the MultiColumnComboBox which is used to display a list of values (dataSource in Kendo UI for jQuery).

The supported values are:

  • A JavaScript object which represents any valid data source configuration.
  • A JavaScript array.
  • An existing kendo.data.DataSource instance.

If the dataSource option is set to a JavaScript object or an array, the MultiColumnComboBox initializes a new kendo.data.DataSource instance by using that value as the data source configuration. If the dataSource option is an existing kendo.data.DataSource instance, the MultiColumnComboBox uses that instance and will not initialize a new one.

data-text-field String

The field of the data item which provides the text content of the list items (dataTextField in Kendo UI for jQuery). Based on the data-text filed, the MultiColumnComboBox filters its data source.

data-value-field String

The field of the data item that provides the value of the widget (dataValueField in Kendo UI for jQuery).

delay Number

The delay (in milliseconds) between a keystroke and the display of the popup (delay in Kendo UI for jQuery).

drop-down-width String | Number

The width of the drop-down (dropDownWidth in Kendo UI for jQuery). Numeric values are treated as pixels.

enable Boolean

If enable is set to false, the MultiColumnComboBox will be disabled and will prevent user input (enable in Kendo UI for jQuery). By default, the MultiColumnComboBox is enabled and allows user input.

enforce-min-length Boolean

If enforce-min-length is set to true, the MultiColumnComboBox will hide part of its items when the text of the search input is cleared (enforceMinLength in Kendo UI for jQuery). By default, the AutoComplete shows all items when the text of the search input is cleared. Works together with minLength.

filter String

Determines the suggestions for the current value (filter in Kendo UI for jQuery). By default, filtering is disabled and can be performed over string values only—the data has to be an array of strings or configured in the dataTextField option.

The supported filter values are:

  • startswith
  • endswith
  • contains

filter-fields Array

Enables multicolumn filtering (filterFields in Kendo UI for jQuery).

fixed-group-template String | Function

The template for rendering the fixed header group (fixedGroupTemplate in Kendo UI for jQuery). By default, the MultiColumnComboBox displays only the value of the current group.

The template for rendering the footer template (footerTemplate in Kendo UI for jQuery). Receives the MultiColumnComboBox itself as part of the data argument. The fields of the MultiColumnComboBox have to be used directly in the template.

group-template String | Function

The template for rendering the groups (groupTemplate in Kendo UI for jQuery). By default, the MultiColumnComboBox displays only the value of the group.

height Number

The height (in pixels) of the suggestion popup (height in Kendo UI for jQuery). Defaults to 200px.

highlight-first Boolean

If highlight-first is set to true, the first suggestion will be automatically highlighted (highlightFirst in Kendo UI for jQuery).

ignore-case Boolean

If ignore-case is set to false, the performed search for finding suggestions will be case-sensitive (ignoreCase in Kendo UI for jQuery). By default, the MultiColumnComboBox performs case-insensitive search.

index Number

The index of the initially selected item which is zero-based (index in Kendo UI for jQuery).

min-length Number

The minimum number of characters which the user must type before a search is performed (minLength in Kendo UI for jQuery). If you set min-length to a value higher than one, the search might match too many items.

no-data-template String | Function

The template for rendering the no-data template which is displayed if no results are found or if the underlying data source is empty (noDataTemplate in Kendo UI for jQuery). The no-data template receives the widget itself as part of the data argument. The template will be evaluated each time databound is triggered.

placeholder String

The hint which is displayed when the widget is empty (placeholder in Kendo UI for jQuery). By default, placeholder is not set.

popup Object

The options for initializing the popup (popup in Kendo UI for jQuery). The supported composite props are available in PopupProps.

suggest Boolean

If suggest is set to true, the MultiColumnComboBox uses the first suggestion as its value (suggest in Kendo UI for jQuery).

sync-value-and-text Boolean

When sync-value-and-text is set to true, the widget sets the selected value to the typed custom text (syncValueAndText in Kendo UI for jQuery). To clear the selected value while keeping the custom text, set sync-value-and-text to false.

header-template String | Function

Specifies static HTML content which will be rendered as a header of the popup element (headerTemplate in Kendo UI for jQuery).

text String

The text of the widget which is used when the autoBind is set to false (text in Kendo UI for jQuery).

value String

The value of the widget (value in Kendo UI for jQuery).

value-primitive Boolean

Specifies the value-binding behavior for the widget when the initial model value is null (valuePrimitive in Kendo UI for jQuery).

  • If value-primitive is set to true, the View-Model field is updated with the selected item text field.
  • If value-primitive is set to false, the View-Model field is updated with the selected item.

virtual Boolean | Object

Enables the virtualization feature of the widget (virtual in Kendo UI for jQuery). You can set virtual to an object which contains the itemHeight and valueMapper properties. For more information, refer to the article on virtualization. The supported composite props are available in VirtualProps.

Events

change: Function

Fires when the user changes the value of the widget (change in Kendo UI for jQuery). As of 2015 Q3 SP1, a cascading MultiColumnComboBox triggers the change event when its value is changed due to an update in the parent MultiColumnComboBox. The event handler function context (available through the this keyword) will be set to the MultiColumnComboBox instance.

close: Function

Fires when the user closes the popup of the widget (close in Kendo UI for jQuery). The event handler function context (available through the this keyword) will be set to the MultiColumnComboBox instance.

databound: Function

Fires when the widget is bound to data from its data source (dataBound in Kendo UI for jQuery). The event handler function context (available through the this keyword) will be set to the MultiColumnComboBox instance.

filtering: Function

Fires when the widget is about to filter the data source (filtering in Kendo UI for jQuery). The event handler function context (available through the this keyword) will be set to the MultiColumnComboBox instance.

open: Function

Fires when the user opens the popup of the widget (open in Kendo UI for jQuery). The event handler function context (available through the this keyword) will be set to the MultiColumnComboBox instance.

select: Function

Fires when the user selects an item from the popup (select in Kendo UI for jQuery).

cascade: Function

Fires when the value of the widget is changed over the API or by user interaction (cascade in Kendo UI for jQuery).

Methods

kendoWidget

returns

Returns the Kendo UI MultiColumnComboBox instance.