| Name | Type | Default | Description |
|---|
| DataSource | object | [] | Configures the set of buttons to be displayed. The dataSource property accepts multiple formats: it can be an array of strings or numbers—each representing a button—or an array of objects, where each object defines the properties of a button (for example, with attributes such as label for the button text and value for its underlying value). Alternatively, dataSource can be a function (callback) that returns an array in either of these formats. This flexibility allows you to define button configurations statically or generate them dynamically based on custom logic. |
| SelectionMode | ButtonGroupSelectionMode | ButtonGroupSelectionMode.One | Specifies how items within the element can be selected—for example, allowing single selection, multiple selections, or no selection at all. |
| Disabled | bool | false | Specifies whether the element is interactive and can be used by the user. When enabled, the element responds to user input; when disabled, the element is non-interactive and usually appears visually distinct to indicate it is unavailable. |
| UnlockKey | string | "" | Defines or retrieves the unlockKey, a unique identifier or code required to activate and gain access to the product’s full features. |
| Locale | string | "en" | Specifies or retrieves the currently selected language for the component. This property works together with messages, which provides the corresponding localized texts or translations for each available language. Changing the language will update the displayed messages based on the selected locale. |
| Messages | object | N/A | Defines or retrieves an object containing text strings used within the widget, allowing these strings to be localized for different languages. This property works in conjunction with the locale property to provide translated text for the widget's user interface, enabling support for internationalization. |
| Name | string | "" | Sets or retrieves the value of the element's name attribute. The name attribute is used to identify form fields when submitting an HTML form, allowing the form data to be sent as key-value pairs to the server. This attribute is essential for grouping related input elements and accessing their submitted values on the server side. |
| Readonly | bool | false | When the custom element has the 'readonly' attribute set, its value cannot be modified by the user. Interaction methods such as typing, selecting, or altering content are disabled; however, users are still able to focus on and copy content from the element if desired. Any attempts to change the value—either via keyboard, mouse, or programmatic user actions—will have no effect. |
| RightToLeft | bool | false | Gets or sets a value that determines whether the element’s layout and text direction are aligned for right-to-left (RTL) locales, such as those using Arabic or Hebrew scripts. When enabled, this property ensures proper alignment and rendering for languages that read from right to left." |
| Theme | string | "" | Specifies the visual theme to be applied to the element. The theme controls the overall appearance, including colors, typography, and style variations, ensuring the element is displayed consistently according to the selected design. |
| SelectedValues | string[] | new string[]{} | Gets or sets the selected values of the button group component as an array of strings. Each string in the array corresponds to the value attribute of a selected button within the group. This property can be used to programmatically read which buttons are currently selected or to define the initial selection state. |
| SelectedIndexes | int[] | new int[]{} | Gets or sets the indexes of the selected buttons within the group as an array of numbers. Each number corresponds to the zero-based index of a selected button. Used to track multiple selected buttons within the group. |
| Unfocusable | bool | false | If set to true, this property prevents the element from receiving keyboard focus, making it unreachable via keyboard navigation (such as the Tab key). |
| Name | Type | Arguments | Description |
|---|
| GetDataSourceAsync() | Task<IEnumerable<object>> | 'N/A' | Gets the "DataSource" property as Task<IEnumerable<object>>. |
| GetSelectedIndexesAsync() | Task<int[]> | 'N/A' | Gets the "SelectedIndexes" property as Task<int[]>. |
| GetSelectedValuesAsync() | Task<string[]> | 'N/A' | Gets the "SelectedValues" property as Task<string[]>. |
| 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 | object value | Toggles the selection state of an item within the element, allowing users to either select or deselect the specified item based on its current state.Args: object value - The index or the value of the item to be selected/unselected. |
| Select | void | int value | Toggles the selection state of an item within the element, allowing users to either select or deselect the specified item based on its current state.Args: int value - The index or the value of the item to be selected/unselected. |
| Select | void | string value | Toggles the selection state of an item within the element, allowing users to either select or deselect the specified item based on its current state.Args: string value - The index or the value of the item to be selected/unselected. |
| StateHasChanged | void | 'N/A' | Refreshes the state and Re-renders the Blazor Component, if necessary. |