SegmentedControl
Introduction
The SegmentedControl component displays a horizontal group of options where only one can be selected at a time. It is useful for view toggles, size options, or similar choices. The component is based on Mantine SegmentedControl.
It is included within the following NPM package: @react-form-builder/components-mantine.
Main properties
The following general properties are available within the Main tab:
| Name | Type | Description |
|---|---|---|
| Value | string | The selected value (uncontrolled value) |
| Data | array | Options (e.g. [{ value: 'a', label: 'Option A' }, ...]) |
| Size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | Size of the control |
| Full width | boolean | If true, segments stretch to fill the container |
| Disabled | boolean | Disables the control |
| On change | event | Fired when the selection changes |
At the bottom of the Main properties menu, you can find additional options:
- Render When: Provides conditional rendering for your component as described in the corresponding chapter.
- HTML attributes: Allows you to provide custom HTML attributes for your form.
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 numberSpecifies the width for your component Height numberSpecifies the height for your component Margin top/right/bottom/left numberMargin values for you component Color stringAllows customizing the text color Background color stringEnables customizing the background color