TagsInput
Introduction
The TagsInput component allows users to enter multiple values as tags, either by typing and confirming or by selecting from suggestions. The component is based on Mantine TagsInput.
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 |
|---|---|---|
| Label | string | Label for the input |
| Value | array | Array of tag strings (uncontrolled value) |
| Data | array | Optional suggestions (e.g. [{ value: 'tag1', label: 'Tag 1' }, ...]) |
| Placeholder | string | Placeholder when empty |
| Description | string | Helper text below the field |
| Error | string | Error message; when set, applies error styling |
| Size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | Size of the input |
| Variant | 'filled' | 'default' | 'unstyled' | Visual variant |
| Disabled | boolean | Disables the input |
| Clearable | boolean | If true, shows clear button |
| On change | event | Fired when the tags change |
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