Getting Started
Components
- Barcodes
- Buttonsupdated
- Chartsupdated
- Conversational UIupdated
- Data Query
- Date Inputsupdated
- Date Math
- Dialogsupdated
- Drawing
- Dropdownsupdated
- - Overview
  - Getting Started
  - AutoCompleteupdated
  - ComboBoxupdated
  - DropDownListupdated
  - DropDownTreeupdated
  - MultiColumnComboBoxupdated
  - MultiSelectupdated
  - MultiSelectTreeupdated
  - Appearance
  - Globalization
  - API
- Editorupdated
- Excel Export
- File Saver
- Filter
- Ganttupdated
- Gauges
- Gridupdated
- Iconsupdated
- Indicators
- Inputsupdated
- Labels
- Layoutupdated
- ListBoxupdated
- ListView
- Mapbeta
- Menusupdated
- Navigationupdated
- Notification
- Pagerupdated
- PDF Export
- PivotGridupdated
- Popup
- ProgressBars
- Ripple
- Schedulerupdated
- ScrollViewupdated
- Sortableupdated
- ToolBarupdated
- Tooltipsupdated
- TreeList
- TreeView
- Typography
- Uploadsupdated
- Utilitiesupdated
Styling & Themes
Common Features
Project Setup
Knowledge Base
Sample Applications
FAQ
Troubleshooting
Updates
Changelogs

Components / Dropdowns / API / AutoCompleteComponent /

New to Kendo UI for Angular? Start a free 30-day trial

AutoCompleteComponent

Represents the Kendo UI AutoComplete component for Angular.

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

Selector

kendo-autocomplete

Export Name

Accessible in templates as #kendoAutoCompleteInstance="kendoAutoComplete"

Inputs

Name	Type	Description
adaptiveMode	`AdaptiveMode`	Enables or disables the adaptive mode. By default the adaptive rendering is disabled.
data	`any`	Sets the data of the AutoComplete. The data has to be provided in an array-like list.
disabled	`boolean`	Sets the disabled state of the component.
fillMode	`DropDownFillMode`	Sets the fillMode of the component. The possible values are: `flat` `solid` (default) `outline` `none`
filterable	`boolean`	Enables the filtering functionality. If set to `true`, the component emits the `filterChange` event.
highlightFirst	`boolean`	Defines whether the first match from the suggestions list will be automatically focused. By default, `highlightFirst` is set to `true`.
itemDisabled	`ItemDisabledFn`	Defines a Boolean function that is executed for each data item in the component (see examples). Determines whether the item will be disabled.
listHeight	`number`	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 AutoComplete.
placeholder	`string`	The hint which is displayed when the component is empty.
popupSettings	`PopupSettings`	Configures the popup of the AutoComplete. The available options are: `animate: Boolean`—Controls the popup animation. By default, the open and close animations are enabled. `width: Number \| String`—Sets the width of the popup container. By default, the width of the host element is used. If set to `auto`, the component automatically adjusts the width of the popup and no item labels are wrapped. The `auto` mode is not supported when virtual scrolling is enabled. `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.
readonly	`boolean`	Sets the read-only state of the component.
rounded	`DropDownRounded`	Sets the border radius of the component. The possible values are: `small` `medium` (default) `large` `full` `none`
size	`DropDownSize`	Sets the size of the component. The possible values are: `small` `medium` (default) `large` `none`
subtitle	`string`	Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices. By default the ActionSheet subtitle uses the text provided for the `placeholder` of the AutoComplete.
suggest	`boolean`	Enables the auto-completion of the text based on the first data item.
tabindex	`number`	Specifies the `tabindex` of the component.
title	`string`	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 AutoComplete.
value	`string`	Sets the value of the AutoComplete.
valueField	`string`	Specifies the `string` property of the data item 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.name`.
virtual	`boolean \| VirtualizationSettings`	Enables the virtualization functionality.

Fields

Name	Type	Default	Description
isOpen	`boolean`		Returns the current open state. Returns `true` if the popup or actionSheet is open.

Events

Name	Type	Description
close	`EventEmitter<PreventableEvent>`	Fires each time the popup is about to close. This event is preventable. If you cancel it, the popup will remain open.
closed	`EventEmitter<any>`	Fires after the popup has been closed.
filterChange	`EventEmitter<string>`	Fires each time the user types in the input field. You can filter the source based on the passed filtration value (see example).
blur	`EventEmitter<any>`	Fires each time the AutoComplete gets blurred.
focus	`EventEmitter<any>`	Fires each time the user focuses the AutoComplete.
open	`EventEmitter<PreventableEvent>`	Fires each time the popup is about to open. This event is preventable. If you cancel it, the popup will remain closed.
opened	`EventEmitter<any>`	Fires after the popup has been opened.
valueChange	`EventEmitter<string>`	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

blur
Blurs the AutoComplete.

focus
Focuses the AutoComplete.

focusItemAt

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

Parameters
index	`number`

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

Product Bundles

DevCraft

Web

Mobile

Document Management

Desktop

Reporting & Mocking

Automated Testing

CMS

UI/UX Tools

Debugging

Extended Reality

Free Tools

AutoCompleteComponent

In this article

Not finding the help you need?

Is this article helpful?

Thank you for your feedback!