All Components

DropDownListComponent

Represents the Kendo UI DropDownList component for Angular.

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

Selector

kendo-dropdownlist

Inputs

defaultItem any

Sets the text of the default empty item. The type of the defined value has to match the data type.

delay number

Sets the delay before an item search is performed. When filtration is disabled, use this option.

disabled boolean

Sets the disabled state of the component.

filterable boolean

Enables the filtering functionality of the DropDownList.

ignoreCase boolean

Enables a case-insensitive search. When filtration is disabled, use this option.

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 DropDownList.

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

open boolean

Sets or gets the open property of the DropDownList. The open property determines whether the popup list of the DropDownList is visible or not.

popupSettings PopupSettings

Configures the popup of the DropDownList.

The available options are:

  • animation: Boolean—Controls the popup animation. By default, the open and close animations are enabled.
  • width: Number—Sets the width of the popup container. By default, the width of the host element is used.
  • height: Number—Sets the height of the popup container. By default, the height is 200px.
  • popupClass: String—Specifies a list of CSS classes that are used to style the popup.

value any

Sets the value of the DropDownList. It could be either of the primitive (string, numbers) or of the complex (objects) type. To define the type, use the valuePrimitive option.

Selected values that are not present in the source are ignored.

Events

filterChange EventEmitter

This event is triggered when the user types in the filter 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 the item selection is changed.

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

valueChange EventEmitter

This event is triggered when value is changed.

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

In this article