RadioGroup
A set of checkable buttons where only one can be checked at a time
Divergence from Blok
RadioGroupItem wraps the button in a flex row with an optional Label string. Blok's RadioGroupItem renders only the circular button + indicator and expects consumers to compose an adjacent <label>. We roll the common case (button + label inline) into a single ergonomic helper so Blazor consumers don't repeat the layout boilerplate. The rendered button, its classes, and its data-slot attributes match Blok exactly — the divergence is the outer wrapper and the Label parameter.
Examples
Default
Selected: option1
Disabled
API
The element family below can be composed together. Click an element to jump to its properties.
| Element | Purpose |
|---|---|
| RadioGroup | Root of the radio group. Holds the currently-selected Value and cascades itself so each RadioGroupItem can report its selection back. |
| RadioGroupItem | One selectable radio button plus its optional inline Label. Clicking the button or the label selects Value on the parent RadioGroup. |
RadioGroup
Root of the radio group. Holds the currently-selected Value and cascades itself so each RadioGroupItem can report its selection back.
| Property | Type | Required | Description |
|---|---|---|---|
| Value | string? | The currently-selected item value. Use @bind-Value for two-way binding. | |
| ValueChanged | EventCallback<string?> | Fires when the user selects a different item. Part of the @bind-Value pair. | |
| Disabled | bool | When true, disables every item in the group. Item-level Disabled is unioned with this. Default: false. | |
| ClassName | string? | Extra CSS classes appended to the outer radiogroup container. | |
| ChildContent | RenderFragment? | Should contain one or more RadioGroupItem children. | |
| AdditionalAttributes | Dictionary<string, object>? | Captured unmatched attributes, forwarded to the outer container. |
RadioGroupItem
One selectable radio button plus its optional inline Label. Clicking the button or the label selects Value on the parent RadioGroup.
| Property | Type | Required | Description |
|---|---|---|---|
| Value | string | The value this item reports back to the parent RadioGroup when selected. | |
| Label | string? | Inline text label rendered next to the button. Blazor-only convenience — Blok expects consumers to place a separate <label>. Default: null. | |
| Disabled | bool | When true, this item cannot be selected even if the parent group is enabled. Default: false. | |
| ClassName | string? | Extra CSS classes appended to the button element. |