All Components

ComboBoxComponent

Represents the Kendo UI ComboBox component for Angular.

@Component({
selector: 'my-app',
template: `
 <kendo-combobox [data]="listItems">
 </kendo-combobox>
`
})
class AppComponent {
  public listItems: Array<string> = ["Item 1", "Item 2", "Item 3", "Item 4"];
}

Selector

kendo-combobox

Inputs

allowCustom boolean

Specifies whether the ComboBox allows user-defined values that are not present in the data set.

disabled boolean

Sets the disabled state of the component.

filterable boolean

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

placeholder string

The hint displayed when the component is empty.

tabIndex number

Specifies the tabIndex of the component.

textField string

Sets the data item field that represents the item text.

If the data contains only primitive values, do not define it.

valueField string

Sets the data item field that represents the item value.

If the data contains only primitive values, do not define it.

valuePrimitive boolean

Specifies the type of the selected value. If set to true, the selected value has to be of a primitive value.

For more details, refer to the section on the valuePrimitive property.

data any

Sets the data of the ComboBox.

The data has to be provided in an array-like list.

open boolean

Sets or gets the open property of the ComboBox.

The open property determines whether the popup list of the ComboBox is visible or not.

value any

Sets the value of the ComboBox. It could be either of the primivite (string, numbers) or of the complex (objects) type. Use the valuePrimitive option to define the type.

Selected values that are not present in the source are considered custom values.

valueNormalizer (value: any) => any

A user-defined callback returning normalized custom values. Typically used when the data items are not of type string.

popupSettings object

Configures the popup of the DropDownList.

The available options of the IPopupSettings are:

  • width: Number—Sets the width of the popup container. By default will be used the width of the host element.
  • height: Number—Sets the height of the popup container. By default height is 200px.

Events

filterChange EventEmitter

This event is triggered when the user types in the input. You can filter the source based on the passed filtration value.

For more details, refer to the section on the filterChange event.

selectionChange EventEmitter

This event is triggered when an item selection is changed.

For more details, refer to the section on the selectionChange event.

valueChange EventEmitter

This event is triggered when the value is changed.

For more details, refer to the section on the valueChange event.

In this article