Select
Introduction
The Select component is a dropdown menu that allows users to choose one option from a list of predefined choices. It provides a compact way to present multiple options while conserving space in forms and interfaces. The component features Material Design styling with proper accessibility support.
The Select component is based on Material UI Select. It is included within the following NPM package: @react-form-builder/components-material-ui.
The Select 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 |
|---|---|---|
| Label | string | Text that is displayed as the label for the dropdown |
| Disabled | boolean | Disables the dropdown, making it non-interactive |
| Variant | choice | Sets the visual variant (outlined, standard, filled) |
| Size | choice | Sets the size of the dropdown (small, medium, large) |
| Error | boolean | Applies error styling to indicate invalid selection |
| Helper text | string | Additional text displayed below the field (e.g., for validation messages) |
| Value | string | Sets the default selected value |
| Items | array | Array of options to display in the dropdown (default: ["Item1", "Item2", "Item3"]) |
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