Package:
@react-form-builder/components-material-ui
· Source code
Introduction
The Radio Group component allows users to select exactly one option from a mutually exclusive set of choices. It presents multiple radio
buttons as a cohesive group where selecting one option automatically deselects others. This component is ideal for scenarios where users
must make a single selection from multiple options, such as choosing a payment method, selecting a category, or picking a preference.
The Radio Group component is based on Material UI Radio Group. It is included within
the following NPM package: @react-form-builder/components-material-ui.
The Radio Group component can be styled and configured to fit specific design and functionality requirements by using various properties
that are presented and described below.
Main properties
The following general properties are available within the Main tab:
| Name | Type | Description |
|---|
| Name | string | Name attribute for the radio group (default: "RadioGroup") |
| Row | boolean | Arranges radio buttons horizontally (row) instead of vertically (column) |
| Value | string | Sets the default selected value |
At the bottom of the Main properties menu, you can find additional options:
Style properties
These are properties that allow to customize the size, color and other style properties of your component:
-
For Device: You can provide component’s style customization for all devices or specific
devices by using this dropdown list. Refer to Adaptive Layout for more
details.
-
Component > Class Name: Add a class name for your component for the subsequent styling if necessary.
-
Wrapper: The options below enable you to tailor the appearance of your component and customize
it for a specific device type, as selected in the For Device property:
| Name | Type | Description |
|---|
| Width | number | Specifies the width for your component |
| Height | number | Specifies the height for your component |
| Margin top/right/bottom/left | number | Margin values for you component |
| Color | string | Allows customizing the text color |
| Background color | string | Enables customizing the background color |
MuiRadioItem properties
Each radio item within the group can be configured with the following properties:
| Name | Type | Description |
|---|
| Value | string | The value associated with this radio button |
| Label | string | Text displayed next to the radio button |
| Color | string | Color of the radio button (e.g., primary, secondary, success, error, info, warning) |
| Disabled | boolean | Disables this specific radio button |
Last modified on April 16, 2026