A semantic form grouping primitive for related controls, legends, descriptions, and validation messages.
import Fieldset from "@radui/ui/Fieldset"- Uses native fieldset and legend elements for grouped form controls
- Propagates disabled state through the browser's form semantics
- Provides description and validation message slots
- Exposes stable data-slot, data-disabled, and data-invalid hooks
Import all parts of the component and piece them together.
The native fieldset element used to group related form controls.
| Prop | Type | Default |
|---|---|---|
customRootClass | string | "" |
disabled | boolean | false |
invalid | boolean | false |
name | string | — |
form | string | — |
color | string | "" |
size | string | "" |
variant | string | "" |
The native legend element that labels the fieldset.
| Prop | Type | Default |
|---|---|---|
children | ReactNode | — |
className | string | — |
Optional descriptive text for the grouped controls.
| Prop | Type | Default |
|---|---|---|
children | ReactNode | — |
id | string | — |
Optional helper or validation message for the grouped controls.
| Prop | Type | Default |
|---|---|---|
invalid | boolean | false |
role | string | — |
children | ReactNode | — |
| Shortcut | Description |
|---|---|
| Tab | Moves focus through enabled form controls inside the fieldset. |
| Reference | What Rad UI follows |
|---|---|
| Fieldset semantics | Uses the native fieldset and legend relationship so assistive technology announces the group label with contained controls. |