| Name | Type | Default | Description |
|---|
| AutoCompleteDelay | int | 100 | Determines the delay before the drop down opens to show the matches from the auto complete operation. The delay is measured in miliseconds. |
| DataSource | object | N/A | Determines the data source that will be loaded to the Input. The dataSource can be an array of strings/numbers or objects where the attributes represent the properties of a List Item. For example label, value. It can also be a callback that returns an Array of items as previously described. |
| Disabled | bool | false | Enables or disables the element. |
| DropDownClassList | IEnumerable<object> | N/A | Sets additional class names to the Input drop down. |
| DropDownButtonPosition | DropDownButtonPosition | DropDownButtonPosition.None | Determines the position of the drop down button. |
| DropDownHeight | object | | Sets the height of the drop down. By default it's set to an empty string. In this case the height of the drop down is controlled by a CSS variable. |
| DropDownWidth | object | | Sets the width of the drop down. By default it's set to an empty string. In this case the width of the drop down is controlled by a CSS variable. |
| InputPurpose | string | "off" | Sets the purpose of the input and what, if any, permission the user agent has to provide automated assistance in filling out the element's input when in a form, as well as guidance to the browser as to the type of information expected in the element. This value corresponds to the standard HTML autocomplete attribute and can be set to values such as 'on', 'name', 'organization', 'street-address', etc. |
| Items | int | 8 | Determines the maximum number of matched items that should be visible inside the drop down as a result of a new autoComplete query. By default the maximum number of 8 items can be displayed inside the drop down. |
| Locale | string | "en" | Sets or gets the language. Used in conjunction with the property messages. |
| Messages | object | N/A | Sets or gets an object specifying strings used in the widget that can be localized. Used in conjunction with the property locale. |
| MinLength | int | 1 | Determines the minimum number of characters inside the input in order to trigger the autocomplete functionality that will open the drop down and show the matched items. |
| Name | string | "" | Sets or gets the name attribute for the element. Name is used when submiting data inside an HTML form. |
| IsOpened | bool | false | Determines whether the drop down is opened or not. |
| Placeholder | string | "" | Determines the placeholder of the input. |
| Query | object | | Sets or gets the query that is used to filter the items. Query is used by the autoComplete operation. Empty string means that all items from the data source will be displayed and no filter query is applied. |
| QueryMode | InputQueryMode | InputQueryMode.ContainsIgnoreCase | Determines the auto complete query mode. This property also determines the matching algorithm for the autocomplete operation. |
| Readonly | bool | false | Determines whether ot not the user can enter text inside the input. if dropDownButtonPosition is set to 'left' or 'right' then readonly determines whether the element acts as a ComboBox or a DropDownList if a dataSource is provided. |
| RightToLeft | bool | false | Sets or gets the value indicating whether the element is aligned to support locales using right-to-left fonts. |
| Sorted | bool | false | Determines whether the items are sorted alphabetically or not |
| SortDirection | string | "asc" | Determines the sorting algorithm - ascending(asc) or descending(desc) if sort is enabled. |
| Theme | string | "" | Determines the theme for the element. Themes define the look of the elements. |
| Type | string | "" | Determines the input type. Input type determines what input can be entered. |
| Unfocusable | bool | false | If is set to true, the element cannot be focused. |
| Value | string | "" | Sets or gets the value of the element. |
| Name | Type | Arguments | Description |
|---|
| Close | void | N/A | Closes the drop down. |
| EnsureVisible | void | N/A | Ensures that the active ( selected ) item is always visible. |
| GetDataSourceAsync() | Task<IEnumerable<object>> | 'N/A' | Gets the "DataSource" property as Task<IEnumerable<object>>. |
| GetIsOpenedAsync() | Task<bool> | 'N/A' | Gets the "IsOpened" property as Task<bool>. |
| GetValueAsync() | Task<string> | 'N/A' | Gets the "Value" property as Task<string>. |
| Open | void | N/A | Opens the drop down. |
| Refresh | void | 'N/A' | Refreshes the Blazor Component. Performs a layout of the HTML Elements and recalculates the measurements. |
| Render | void | 'N/A' | Re-renders the Blazor Component. This method will make a full re-render. |
| Select | void | N/A | Selects the text inside the input or if it is <b>readonly</b> then the element is focused. |
| StateHasChanged | void | 'N/A' | Refreshes the state and Re-renders the Blazor Component, if necessary. |
| Name | Type | Description | Event Detail |
|---|
| OnChange | EventCallback<Event> | This event is triggered when the selection is changed. | string label- The label of the new selected item., dynamic oldLabel- The label of the item that was previously selected before the event was triggered., dynamic oldValue- The value of the item that was previously selected before the event was triggered., dynamic value- The value of the new selected item. |
| Changed | event InputChangedEventHandler | This event is triggered when the selection is changed. | InputChangedEventArgs |
| OnChanging | EventCallback<Event> | This event is triggered on each key up event of the Input, if the value is changed. | dynamic oldValue- The previous value before it was changed., dynamic value- The new value. |
| Changing | event InputChangingEventHandler | This event is triggered on each key up event of the Input, if the value is changed. | InputChangingEventArgs |
| OnItemClick | EventCallback<Event> | This event is triggered when the user clicks on an item from the popup list. | dynamic item- The item that was clicked., string label- The label of the item that was clicked., dynamic value- The value of the item that was clicked. |
| ItemClicked | event InputItemClickedEventHandler | This event is triggered when the user clicks on an item from the popup list. | InputItemClickedEventArgs |