Blazorise Radio component
The Radio
allow the user to select a single option from a group.
Radio Button Group allows the user to select exactly one value from a list of related, but mutually exclusive, options.
Structure
<RadioGroup>
<Radio>
Examples
Basic RadioGroup
RadioGroup
is a helpful wrapper used to group Radio
components that provides an easier API,
and proper keyboard accessibility to the group.
<RadioGroup TValue="string" Name="colors"> <Radio Value="@("red")">Red</Radio> <Radio Value="@("green")">Green</Radio> <Radio Value="@("blue")">Blue</Radio> </RadioGroup>
Important Note:
For the
RadioGroup
and Radio
components to work correctly, the TValue
type must match across both. This is especially important when using nullable types, as mismatched types can lead to unexpected behavior.
Standalone Radio
Radio
can also be used standalone, without the RadioGroup
wrapper.
<Radio TValue="string" Group="colors" Value="@("red")">Red</Radio> <Radio TValue="string" Group="colors" Value="@("green")">Green</Radio> <Radio TValue="string" Group="colors" Value="@("blue")">Blue</Radio>
RadioGroup Buttons
By setting theButtons
flag, radios will be grouped together and will appear as buttons.
<RadioGroup TValue="string" Name="colors" Buttons> <Radio Value="@("red")">Red</Radio> <Radio Value="@("green")">Green</Radio> <Radio Value="@("blue")">Blue</Radio> </RadioGroup>
Binding
Two-way binding
<RadioGroup TValue="string" Name="colors" @bind-CheckedValue=""> <Radio Value="@("red")">Red</Radio> <Radio Value="@("green")">Green</Radio> <Radio Value="@("blue")">Blue</Radio> </RadioGroup>
@code{ string checkedValue = "green"; }
Manual event binding
<RadioGroup TValue="string" Name="colors" CheckedValue="" CheckedValueChanged=""> <Radio Value="@("red")">Red</Radio> <Radio Value="@("green")">Green</Radio> <Radio Value="@("blue")">Blue</Radio> </RadioGroup>
@code{ string checkedValue = "green"; Task OnCheckedValueChanged( string value ) { checkedValue = value; return Task.CompletedTask; } }
API
Attributes
RadioGroup
Name | Description | Type | Default |
---|---|---|---|
TValue |
CheckedValue data type.
|
generic |
|
CheckedValue |
Gets or sets the checked value. | TValue |
default |
CheckedValueChanged |
Occurs when the checked value is changed. | EventCallback<TValue> |
|
Name |
Defines the radio group name. | string |
null |
Orientation |
Defines the orientation of the radio elements. | Orientation |
Horizontal |
Buttons |
Flag which indicates that radios will appear as button. | bool |
false |
Color |
Defines the color or radio buttons(only when Buttons is true).
|
Color |
Secondary |
Radio
Name | Description | Type | Default |
---|---|---|---|
TValue |
Data type of Checked value. Support types are bool and bool? .
|
generic |
|
Checked |
Gets or sets the checked value. | TValue |
default |
CheckedChanged |
Occurs when the checked value is changed. | EventCallback<TValue> |
|
Group |
Defines the radio group name. | string |
null |
Inline |
Group radios on the same horizontal row. | bool |
false |
Cursor |
Defines the mouse cursor based on the behavior by the current CSS framework. | Cursor |
Default |