# Fieldset

Fields grouped under a legend, in an inset card on the tray.

Tier: Free

## Installation

```bash
npx shadcn add @fetaui/fieldset
```

## Usage

```tsx
import { Fieldset, FieldRow } from '@/components/fetaui/fieldset'

export function Example() {
  return (
    <Fieldset legend="Address">
      <FieldRow>{/* two fields */}</FieldRow>
    </Fieldset>
  )
}
```

## API

| Prop | Type | Default |
|---|---|---|
| legend | ReactNode | required |
| description | ReactNode |  |
| disabled | boolean | false |

## When to use

- To group fields that belong together, like an address.

## When not to use

- For a single field: use Field.

## Accessibility

- A native fieldset and legend, so the group is announced.
- Disabling the fieldset disables every control in it.

## Motion

- Fieldset has no motion of its own. The controls inside keep theirs.