Radio Group
As defined by the W3C:
A radio group is a set of checkable buttons, known as radio buttons, where no more than one of the buttons can be checked at a time. Some implementations may initialize the set with all buttons in the unchecked state in order to force the user to check one of the buttons before moving past a certain point in the workflow.
While any DOM content is permissible as a child of the radiogroup, only <FluentRadio>
's and slotted content with a role of
radio
will receive keyboard support.
<FluentRadioGroup>
wraps the <fluent-radio-group>
element, a web component implementation of a radio group leveraging the
Fluent UI design system.
Examples
Default
Selected: ()
Selected: ()
In a toolbar
States
Read only
Disabled
Label outside group
With label outside group
Your favorite fruit: apples!
With preset
Preset value
The best pilot according to you is: maverick!
Your favorite pilot: maverick!
Documentation
FluentRadioGroup<TValue> Class
Inherits from FluentInputBase<TValue>.
There might be parameters and/or methods shown here that are inherited from the component's base type but are not applicable to this component.
Note: Although the component is generic, it only supports simple types likeint
,string
andbool
.
Parameters
Name | Type | Default | Description |
---|---|---|---|
AriaLabel | string? | Gets or sets the text used on aria-label attribute. | |
Autofocus | bool | False | Determines if the element should receive document focus on page load. |
ChildContent | RenderFragment? | Gets or sets the child content to be rendering inside the FluentRadioGroup . | |
Disabled | bool | False | Disables the form control, ensuring it doesn't participate in form submission. |
DisplayName | string? | Gets or sets the display name for this field. | |
Embedded | bool | False | Gets or sets if the derived component is embedded in another component. If true, the ClassValue property will not include the EditContext's FieldCssClass. |
Field | FieldIdentifier? | Gets or sets the FluentInputBase that identifies the bound value.If set, this parameter takes precedence over FluentInputBase . | |
Immediate | bool | False | Change the content of this input field when the user write text (based on 'OnInput' HTML event). |
ImmediateDelay | int | 0 | Gets or sets the delay, in milliseconds, before to raise the FluentInputBase event. |
Label | string? | Gets or sets the text to label the input. This is usually displayed just above the input | |
LabelTemplate | RenderFragment? | Gets or sets the content to label the input component. This is usually displayed just above the input | |
Name | string? | Gets or sets the name of the element. Allows access by name from the associated form. ⚠️ This value needs to be set manually for SSR scenarios to work correctly. | |
Orientation | Orientation? | Gets or sets the orientation of the group. See Orientation | |
Placeholder | string? | Gets or sets the short hint displayed in the input before the user enters a value. | |
ReadOnly | bool | False | When true, the control will be immutable by user interaction. readonly HTML attribute for more information. |
Required | bool | False | Gets or sets a value indicating whether the element needs to have a value. |
Value | TValue? | Gets or sets the value of the input. This should be used with two-way binding. | |
ValueExpression | Expression<Func<TValue>>? | Gets or sets an expression that identifies the bound value. |
EventCallbacks
Name | Type | Description |
---|---|---|
ValueChanged | EventCallback<TValue> | Gets or sets a callback that updates the bound value. |
Methods
Name | Parameters | Type | Description |
---|---|---|---|
FocusAsync | void | Exposes the elements FocusAsync(bool preventScroll) method. | |
FocusAsync | bool preventScroll | void | Exposes the elements FocusAsync(bool preventScroll) method. |