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

Export Name

Accessible in templates as #kendoDropDownListInstance="kendoDropDownList"

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.

listHeight number

Sets the height of the options list. 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.

loading boolean

Sets and gets the loading state of the DropDownList.

readonly boolean

Sets the read-only state of the component.

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.

popupSettings PopupSettings

Configures the popup of the DropDownList.

The available options are:

  • animate: 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.
  • popupClass: String—Specifies a list of CSS classes that are used to style the popup.
  • appendTo: "root" | "component" | ViewContainerRef—Specifies the component to which the popup will be appended.

value any

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

All selected values which are not present in the source are ignored.

Fields

isOpen boolean

Returns the current open state of the popup.

Events

close EventEmitter

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

filterChange EventEmitter

Fires each time the user types in the input field.
You can filter the source based on the passed filtration value.
For more details, refer to the example on events.
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.

blur EventEmitter

Fires each time the DropDownList gets blurred.

focus EventEmitter

Fires each time the user focuses the DropDownList.

open EventEmitter

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

selectionChange EventEmitter

Fires each time the item selection is changed.
For more details, refer to the example on events.

valueChange EventEmitter

Fires each time the value is changed—
when the component is blurred or the value is cleared through the Clear button.
For more details, refer to the example on events.

Methods

blur

Blurs the DropDownList.

focus

Focuses the DropDownList.

reset

Resets the value of the DropDownList.
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.

toggle

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

Parameters

open boolean

The state of the popup.

In this article