AutoComplete Events
This article explains the events available in the Telerik AutoComplete for Blazor:
ValueChanged
The ValueChanged event fires on every user keystroke that changes the textbox value.
Handle AutoComplete ValueChanged
The event is an
EventCallback. It can be synchronous and returnvoid, or asynchronous and returnasync Task. Do not useasync void.
The lambda expression in the handler is required by the framework: https://github.com/aspnet/AspNetCore/issues/12226.
Handle ValueChanged and provide initial value
OnChange
The OnChange event represents a user action - confirmation of the current value/item. The key differences with ValueChanged are:
OnChangedoes not prevent two-way binding (the@bind-Valuesyntax)OnChangefires when the user pressesEnterin the input, or blurs the input (for example, clicks outside of the input or dropdown). It does not fire on every keystroke, but it fires when an item is selected from the dropdown.
Handle OnChange
OnRead
You can use the OnRead event to provide data to the component based on custom logic and the current user input and/or scroll position (when using virtualization). The event fires when:
- The component initializes.
- The user filters.
- The user scrolls with virtualization enabled.
You can also call remote data through async operations.
Find out how to get the applied filtering and grouping criteria.
When using OnRead, make sure to set TItem and TValue.
Custom Data according to the user input in the AutoComplete
Filter large local data through the Telerik DataSource extensions
OnOpen
The OnOpen event fires before the AutoComplete popup renders.
The event handler receives as an argument an AutoCompleteOpenEventArgs object that contains:
| Property | Description |
|---|---|
IsCancelled | Set the IsCancelled property to true to cancel the opening of the popup. |
OnClose
The OnClose event fires before the AutoComplete popup closes.
The event handler receives as an argument an AutoCompleteCloseEventArgs object that contains:
| Property | Description |
|---|---|
IsCancelled | Set the IsCancelled property to true to cancel the closing of the popup. |
OnItemRender
The OnItemRender event fires when each item in the AutoComplete dropdown renders.
The event handler receives as an argument an AutoCompleteItemRenderEventArgs<TItem> object that contains:
| Property | Description |
|---|---|
Item | The current item that renders in the AutoComplete. |
Class | The custom CSS class that will be added to the item. |
OnBlur
The OnBlur event fires when the component loses focus.
Handle the OnBlur event