New to Kendo UI for AngularStart a free 30-day trial

Represents the Kendo UI MultiColumnComboBox component for Angular.

Use the MultiColumnComboBoxComponent to show a dropdown list with multiple columns. See example.

Definition

Package:@progress/kendo-angular-dropdowns

Selector:kendo-multicolumncombobox

Syntax:

html
<kendo-multicolumncombobox [data]="data" [columns]="columns"></kendo-multicolumncombobox>

Inputs

Enables or disables the adaptive mode. By default, adaptive rendering is disabled.

Default:

'none'

Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices. By default, the ActionSheet does not render a subtitle.

Sets the title of the ActionSheet that is rendered instead of the Popup when using small screen devices. By default, the ActionSheet title uses the text provided for the label of the ComboBox.

Default:

''

Specifies whether the ComboBox allows user-defined values that are not present in the dataset (more information and examples). Defaults to false.

The feature is not available when using adaptive mode.

Default:

false

If set to true, renders a button on hovering over the component. Clicking this button resets the value of the component to undefined and triggers the change event.

Default:

true

data

any

Sets the data of the ComboBox. The data must be provided in an array-like list.

disabled

boolean

Sets the disabled state of the component. To learn how to disable the component in reactive forms, refer to the articles on ComboBox Forms Support and MultiColumnComboBox Forms Support.

Default:

false

Sets the fillMode of the component. The default value is set by the Kendo theme.

filterable

boolean

Enables the filtering functionality. If set to true, the component emits the filterChange event.

Default:

false

inputAttributes

{ [key: string]: string }

Sets the HTML attributes of the inner focusable input element. Attributes essential for certain component functionalities cannot be changed.

Defines a Boolean function that is executed for each data item in the component (see examples). Determines whether the item is disabled.

Sets the height of the options list in the popup. By default, listHeight is 200px.

The listHeight property affects only the list of options and not the whole popup container. To set the height of the popup container, use popupSettings.height.

When using adaptiveMode and the screen size is small or medium the listHeight property is set to null.

loading

boolean

Sets and gets the loading state of the ComboBox.

The hint that is displayed when the component is empty.

Default:

""

Configures the popup of the ComboBox.

readonly

boolean

Sets the read-only state of the component.

Default:

false

Sets the border radius of the component. The default value is set by the Kendo theme.

Shows or hides the current group sticky header when using grouped data. By default the sticky header is displayed (see example).

Default:

true

Sets the size of the component. The default value is set by the Kendo theme.

suggest

boolean

Enables the auto-completion of the text based on the first data item.

Default:

false

tabindex

number

Specifies the tabindex of the component.

Default:

0

textField

string

Sets the data item field that represents the item text. If the data contains only primitive values, do not define this property.

The textField property can be set to a nested property value, for example, category.name.

Sets the value of the ComboBox. The value can be a primitive (string, number) or a complex object. Use the valuePrimitive property to define the type.

All selected values not present in the dataset are custom values. When the Enter key is pressed or the component loses focus, custom values are dismissed unless allowCustom is set to true.

Sets the data item field that represents the item value. If the data contains only primitive values, do not define it.

The valueField property can be set to point to a nested property value - e.g. category.id.

A user-defined callback which returns normalized custom values. Typically used when the data items are different from type string.

Parameters:textObservable​<string>Returns:

Observable​<any>

Specifies the type of the selected value. If set to true, the selected value must be a primitive type. (more information and example)

Enables the virtualization functionality.

Fields

Contains a query list of all declared ComboBoxColumnComponent columns. Use this property to access and configure the columns displayed in the dropdown.

isOpen

boolean

Returns the current open state. Returns true if the popup or actionSheet is open.

Events

Fires each time the ComboBox gets blurred.

close

EventEmitter​<PreventableEvent>

Fires each time the popup is about to close. This event is preventable. If you cancel it, the popup remains open.

Fires after the popup has been closed.

Fires each time the user types in the input field. You can filter the source based on the passed filtration value (see example).

Fires each time the user focuses the ComboBox.

Fires each time the input element gets blurred.

Fires each time the user focuses the input element.

open

EventEmitter​<PreventableEvent>

Fires each time the popup is about to open. This event is preventable. If you cancel it, the popup remains closed.

Fires after the popup has been opened.

Fires each time an item selection is changed (see example).

Fires each time the value is changed— when the component is blurred or the value is cleared through the Clear button (see example). When the value of the component is programmatically changed to ngModel or formControl through its API or form binding, the valueChange event is not triggered because it might cause a mix-up with the built-in valueChange mechanisms of the ngModel or formControl bindings.

Methods

Blurs the ComboBox.

Focuses the ComboBox.

Focuses a specific item of the ComboBox based on a provided index. If null or invalid index is provided the focus will be removed.

Parameters:indexnumber

Resets the value of the ComboBox. If you use the reset method to clear the value of the component, the model will not update automatically and the selectionChange and valueChange events will not be fired.

Toggles the visibility of the popup or actionSheet. If you use the toggle method to open or close the popup or actionSheet, the open and close events will not be fired.

Parameters:open?boolean

The state of the popup.