Blazor DropDown
The Radzen Blazor DropDown lets users pick a value from a list - a select / combobox with data binding, filtering, multiple selection, grouping, templates, and virtualization for large lists.
Get and Set the value of DropDown linkLink to this section
As all Radzen Blazor input components the DropDown has a Value property which gets and sets the value of the component. Use @bind-Value to get the user input.
Get and Set the value of DropDown using Value and Change event linkLink to this section
Value property can be used to set the value of the component and Change event to get the user input.
Define Text and Value properties linkLink to this section
Use the TextProperty and ValueProperty properties to specify which fields to display and use as values.
DropDown with templates linkLink to this section
Use the Template,HeaderTemplate and FooterTemplate properties to customize the dropdown list.
Disable specific item linkLink to this section
Use the IsDisabled parameter of RadzenDropDownItem to disable specific items in the dropdown.
Clear selected item linkLink to this section
Use the AllowClear property to enable a clear button that allows users to deselect the current selection.
Editable DropDown linkLink to this section
Use the ValueTemplate with an embedded input bound to the same value to let users edit the selected item in place. Set ShowValueTemplateOnEmpty to true to render the template (and its editor) even when no item is selected, so the user can type an initial value without first picking from the list. The pattern requires the DropDown Value to be the displayed text itself (e.g. a primitive type) and is not designed for use with TextProperty/ValueProperty.
Open and close events linkLink to this section
Handle the Open and Close events to respond when the dropdown popup is opened or closed.
DropDown Sizes linkLink to this section
Use the InputSize property to set the DropDown size. Available sizes are ExtraSmall, Small, Medium (default), and Large.
Keyboard Navigation linkLink to this section
The following keys or key combinations provide a way for users to navigate and interact with Radzen Blazor DropDown component.
| Press this key | To do this |
|---|---|
| Alt + DownArrow | Open the DropDown popup. |
| Alt + UpArrow | Close the DropDown popup. |
| DownArrow / RightArrow on closed popup | Single selection: move to and select the next item. Multiple selection: move focus to the next item without changing the selection. |
| UpArrow / LeftArrow on closed popup | Single selection: move to and select the previous item. Multiple selection: move focus to the previous item without changing the selection. |
| DownArrow / RightArrow in an opened popup | Focus the next DropDown item. |
| UpArrow / LeftArrow in an opened popup | Focus the previous DropDown item. |
| Home in an opened popup | Focus first DropDown item. |
| End in an opened popup | Focus last DropDown item. |
| Enter in an opened popup | Single selection: select the focused item and close the popup. Multiple selection: toggle the focused item and keep the popup open. |
| Enter on closed popup | Open the popup. |
| Space in an opened popup | Select/toggle the focused item. |
| Space on closed popup | Open the popup. |
| Esc in an opened popup | Close the popup (focus returns to the DropDown). |
| Tab | Close the popup if open and move focus to the next element. |
| Delete | Clear the selection when AllowClear is enabled. In multiple selection mode all selected items are cleared. |
| Printable character | Focus the next item whose text starts with it (repeat to cycle). |
Frequently asked questions
How do I bind data to the Blazor DropDown?
Set the Data property to any IEnumerable or IQueryable and use TextProperty and ValueProperty to choose the display text and the bound value. Bind the selection with @bind-Value.
How do I enable multiple selection (multiselect)?
Set Multiple to true and bind Value to a collection. The DropDown then shows checkboxes and a summary of the selected items.
How do I add search or filtering to the DropDown?
Set AllowFiltering to true so users can type to filter the list. You can choose the filter operator and case sensitivity, or load filtered data on demand.
Can the DropDown handle large lists?
Yes. Turn on virtualization and bind to an IQueryable so only the visible options are rendered and fetched, which keeps it fast on very large lists.
Radzen Blazor Components, © 2018-2026 Radzen.
Source Code licensed under
MIT