MultiComboInput Properties
| Name | Type | Default | Description |
|---|---|---|---|
| AutoCompleteDelay | int | 100 | Specifies the amount of time, in milliseconds, to wait before displaying the dropdown menu that shows matching suggestions from the autocomplete operation. This delay begins after the user stops typing, allowing for smoother user experience and reducing unnecessary searches. |
| HideInputTagsCloseButton | bool | false | Controls the visibility of close buttons when multiple items are selected. If enabled, close buttons will be displayed for each selected item, allowing users to remove individual items. If disabled, close buttons will be hidden, preventing users from removing selected items individually. |
| ColorItems | bool | true | Controls whether the background color of an item's tag is automatically set to match the value specified in the item's 'color' property. When enabled, if an item has a 'color' property defined, its tag background will automatically use that color. When disabled, the tag background will not be affected by the 'color' property. |
| DataSource | object | N/A | Specifies the source of data to be displayed in the MultiInput component. The dataSource can accept multiple formats: - An array of strings or numbers, where each entry is used as both the display value and the selection value of a list item. - An array of objects, where each object represents a list item. The object’s attributes (such as label and value) define the display text and internal value of each item. - A callback function that returns an array in either of the formats listed above. Use this property to flexibly provide static data or implement dynamic data loading for the MultiInput component. |
| Disabled | bool | false | Specifies whether the element is interactive or inactive. When enabled, users can interact with the element; when disabled, the element is non-interactive and typically rendered with a visually distinct, disabled appearance. |
| DropDownButtonPosition | DropDownButtonPosition | DropDownButtonPosition.Right | Specifies the alignment or placement of the dropdown button relative to its parent element or container, such as positioning it to the left, right, center, or at a custom location within the interface. This property controls where the dropdown button will appear within its context. |
| DropDownHeight | object | Specifies the height of the dropdown menu. By default, this property is set to an empty string, which means the dropdown’s height is determined by a corresponding CSS variable rather than a fixed value. If a specific height value is provided, it will override the CSS variable and directly set the dropdown’s height. | |
| DropDownWidth | object | Specifies the width of the dropdown menu. By default, this property is set to an empty string, which means the dropdown's width will be determined by the corresponding CSS variable (typically a custom property defined in your stylesheet). You can override this behavior by providing a specific width value (such as "200px", "50%", etc.), which will directly set the dropdown's width instead of relying on the CSS variable. | |
| InputPurpose | string | "off" | Specifies the expected type of information for the input element—such as a user's name, email, or address—and guides the browser on how to provide relevant autofill suggestions when the element is used within a form. This property maps directly to the standard HTML autocomplete attribute. By setting values like 'on', 'off', 'name', 'email', 'organization', or 'street-address', you can instruct the browser on whether, and how, to assist the user with automated form filling. Proper use of this property enhances both the accuracy and security of autofill features, as well as improving the overall user experience. |
| Items | int | 8 | Specifies the maximum number of matching items to display in the dropdown menu when a new autoComplete query is performed. By default, up to 8 items will be visible in the dropdown at any one time. If more matches are found, only the first 8 will be shown, while additional results can be accessed through scrolling or pagination, depending on the implementation. |
| UnlockKey | string | "" | Gets or sets the 'unlockKey' property, which is a unique code required to activate or unlock the product's full features. Use this key to enable product access or retrieve the current key assigned to the product. |
| Locale | string | "en" | Specifies or retrieves the current language setting. This property works together with the messages property to display content or interface text in the selected language. When the language is set, the corresponding messages from the messages object will be used for localization. |
| Messages | object | N/A | Specifies or retrieves an object containing strings used for localization within the widget. This property allows you to define custom, translatable text for various user interface elements, ensuring that the widget can display content in different languages. It is used in combination with the locale property to adapt the widget's text to the selected language or regional setting. |
| MinLength | int | 1 | Specifies the minimum number of characters a user must enter into the input field before the autocomplete feature activates. Once this threshold is reached, the dropdown will open and display a list of items that match the entered text. |
| Name | string | "" | Sets or retrieves the value of the element's name attribute. The name attribute uniquely identifies form elements when data is submitted to the server, enabling key-value pairs to be correctly processed. This is essential in HTML forms to ensure each input's data is associated with its corresponding name. |
| IsOpened | bool | false | Specifies whether the dropdown menu is currently open (visible) or closed (hidden). |
| Placeholder | string | "" | Specifies the placeholder text displayed inside the input field when it is empty, providing a hint or example of the expected input value to the user. |
| Pills | bool | false | Controls whether the items in the drop-down menu are visually displayed as pill-shaped elements. When enabled, each item will have a rounded, pill-like appearance. When disabled, items will use the default style. |
| Query | object | Defines or retrieves the search query used to filter items in the data source. This query is utilized by the autoComplete operation to determine which items are displayed based on user input. If the value is set to an empty string, all items from the data source are shown and no filtering is applied. | |
| QueryMode | MultiComboInputQueryMode | MultiComboInputQueryMode.ContainsIgnoreCase | Specifies the autocomplete query mode, which defines how user input is matched against available options during the autocomplete operation. This property selects the matching algorithm used to filter and suggest results based on the entered query, such as prefix matching, exact matching, or fuzzy searching. |
| Readonly | bool | false | Determines whether the user can enter or edit text within the input field. When the dropDownButtonPosition property is set to either 'left' or 'right', the readonly property controls the component's behavior when a dataSource is provided: - If readonly is false, the element functions as a ComboBox, allowing users to type custom values as well as select from the list.- If readonly is true, the element behaves as a DropDownList, restricting the user to select only from the available options without the ability to enter custom text. |
| RightToLeft | bool | false | Configures or retrieves the value that determines whether the element's alignment is adjusted to support right-to-left (RTL) languages and scripts, such as Arabic or Hebrew. When enabled, the element's layout and text direction are oriented to accommodate RTL reading order for proper localization. |
| Separator | string | "" | Specifies the character or string used to separate individual tags within the input field. This delimiter defines how the input is parsed into distinct tags when users enter multiple values. |
| SingleSelect | bool | false | Specifies if selection is restricted to a single item at a time, preventing users from selecting multiple items simultaneously. |
| SelectAll | bool | false | Controls the display of an extra option at the top of the options list, which enables users to select or deselect all items with a single action. When enabled, this option appears as the first item, providing a convenient way to manage the entire selection at once. |
| SelectedValues | IEnumerable<object> | N/A | Gets or sets an array containing the currently selected values. This property allows you to retrieve the list of selected items or update the selection by assigning a new array of values. Each value in the array corresponds to an item that has been selected. |
| Sorted | bool | false | Specifies whether the items are arranged in alphabetical order. If set to true, the items will be sorted from A to Z; if false, the original order will be preserved. |
| SortDirection | string | "asc" | Specifies the sorting algorithm to be used when sort is enabled. Accepts either asc for ascending order or desc for descending order, determining how the data will be organized. |
| InputTagsMode | MultiComboInputInputTagsMode | MultiComboInputInputTagsMode.Many | Specifies how selected items are displayed in the input field: either as individual tags for each selected item from the popup, or as a single tag that displays the total number of items selected. |
| Theme | string | "" | Specifies the visual theme to apply to the element. The selected theme controls the element’s overall appearance, including colors, fonts, and styles, ensuring consistency with the application's design scheme. |
| Type | string | "" | Specifies the type of input that the field accepts, such as text, email, password, number, or date. The selected input type defines both the format of data that can be entered by the user and the behavior of the input field, including related validation and the appearance of the on-screen keyboard (on supported devices). |
| Unfocusable | bool | false | When set to true, this property prevents the element from receiving keyboard focus. As a result, users will not be able to navigate to the element using the Tab key or other keyboard navigation methods. |
| Value | string | "" | Sets or retrieves the current value of the element. When used as a setter, it assigns the specified value to the element (such as updating the text in an input field or the selected option in a dropdown). When used as a getter, it returns the element’s current value. |
MultiComboInput Methods
| Name | Type | Arguments | Description |
|---|---|---|---|
| Close | void | N/A | Closes the dropdown menu by hiding its content and updating its state to indicate that it is no longer visible or active. |
| EnsureVisible | void | N/A | Guarantees that the currently selected item remains within the visible area of the container, automatically scrolling as needed to bring the active item into view whenever selection changes. |
| 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>. |
| GetSelectedValuesAsync() | Task<IEnumerable<object>> | 'N/A' | Gets the "SelectedValues" property as Task<IEnumerable<object>>. |
| GetValueAsync() | Task<string> | 'N/A' | Gets the "Value" property as Task<string>. |
| Open | void | N/A | Displays the dropdown menu, allowing users to view and select available options. |
| 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 all the text within the input field. If the input field is set to <b>readonly</b>, the method will focus the element instead, since text selection is not allowed for readonly inputs. |
| StateHasChanged | void | 'N/A' | Refreshes the state and Re-renders the Blazor Component, if necessary. |
MultiComboInput Events
| Name | Type | Description | Event Detail |
|---|---|---|---|
| OnChange | EventCallback<Event> | This event is triggered whenever the user modifies the current selection, such as highlighting different text or choosing a new option within a selectable element. It enables you to respond programmatically to changes in the selected content or options. | 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 MultiComboInputChangedEventHandler | This event is triggered whenever the user modifies the current selection, such as highlighting different text or choosing a new option within a selectable element. It enables you to respond programmatically to changes in the selected content or options. | MultiComboInputChangedEventArgs |
Enums
DropDownButtonPosition
| DropDownButtonPosition.None |
| DropDownButtonPosition.Left |
| DropDownButtonPosition.Right |
MultiComboInputQueryMode
| MultiComboInputQueryMode.Contains |
| MultiComboInputQueryMode.ContainsIgnoreCase |
| MultiComboInputQueryMode.DoesNotContain |
| MultiComboInputQueryMode.DoesNotContainIgnoreCase |
| MultiComboInputQueryMode.Equals |
| MultiComboInputQueryMode.EqualsIgnoreCase |
| MultiComboInputQueryMode.StartsWith |
| MultiComboInputQueryMode.StartsWithIgnoreCase |
| MultiComboInputQueryMode.EndsWith |
| MultiComboInputQueryMode.EndsWithIgnoreCase |
MultiComboInputInputTagsMode
| MultiComboInputInputTagsMode.One |
| MultiComboInputInputTagsMode.Many |