# Sheet

> A panel that slides in from an edge and can be swiped away: inspectors, edit forms, mobile navigation.

Category: Overlays · Atomic level: organism · Built on Base UI Drawer
Page: https://ui.dtheo.dev/docs/components/sheet

## Install

```bash
npx dtheo@latest add sheet
# or, with the shadcn CLI
npx shadcn@latest add https://ui.dtheo.dev/r/sheet.json
```

Dependencies: @base-ui/react, clsx, tailwind-merge, lucide-react. Registry dependencies: utils.

## Exports

`Sheet`, `SheetTrigger`, `SheetContent`, `SheetHeader`, `SheetTitle`, `SheetDescription`, `SheetBody`, `SheetFooter`, `SheetClose`

## Use it for

- Editing an item while keeping the list in view
- Mobile navigation and actions

## Reach for something else

- Blocking decisions that need an answer now: use Alert dialog
- Short forms tied to one control: use Popover

## Keyboard

| Keys | Action |
| --- | --- |
| Escape | Closes the sheet |

## Accessibility

- Swipe to dismiss follows the finger 1:1 and accepts a flick; it leaves in the direction it entered.

## Examples

### sheet

```tsx
import * as React from 'react';
import { Button } from '@/components/ui/button';
import { Field, FieldLabel } from '@/components/ui/field';
import { Input } from '@/components/ui/input';
import { NumberField } from '@/components/ui/number-field';
import {
  Sheet,
  SheetBody,
  SheetClose,
  SheetContent,
  SheetDescription,
  SheetFooter,
  SheetHeader,
  SheetTitle,
} from '@/components/ui/sheet';
import { Textarea } from '@/components/ui/textarea';
import { useToast } from '@/components/ui/toast';

const initialRuns = [
  {
    id: 'R-0410',
    name: 'Nominal step',
    time: '09:12',
    kp: 3.2,
    kd: 0.08,
    note: 'Clean response, 4.1 % overshoot.',
  },
  { id: 'R-0411', name: 'Damped step', time: '11:05', kp: 3.6, kd: 0.12, note: '' },
  {
    id: 'R-0412',
    name: 'High-gain step',
    time: '14:32',
    kp: 4.2,
    kd: 0.06,
    note: 'Overshoot 17.6 %, over the 15 % limit.',
  },
];
const twoDecimals = { minimumFractionDigits: 2, maximumFractionDigits: 2 };

export default function SheetExample() {
  const toast = useToast();
  const [runs, setRuns] = React.useState(initialRuns);
  const [open, setOpen] = React.useState(false);
  const [run, setRun] = React.useState(initialRuns[2]!);

  const save = (e: React.FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const name = String(new FormData(e.currentTarget).get('name') ?? '').trim() || run.name;
    setRuns((all) => all.map((r) => (r.id === run.id ? { ...r, name } : r)));
    setOpen(false);
    toast.add({ title: `${run.id} saved`, type: 'success' });
  };

  return (
    <>
      {/* The list stays in view behind the sheet, so you can see which run you are editing. */}
      <ul className="flex w-full max-w-sm flex-col divide-y divide-border rounded-card border border-border bg-card">
        {runs.map((r) => (
          <li key={r.id} className="flex items-center gap-3 py-1.5 pr-1.5 pl-3">
            <span className="min-w-0 flex-1 truncate text-body">
              <span className="font-medium tabular-nums">{r.id}</span>
              <span className="text-muted-foreground"> · {r.name}</span>
            </span>
            <Button
              size="sm"
              variant="ghost"
              aria-label={`Edit ${r.id}`}
              onClick={() => {
                setRun(r);
                setOpen(true);
              }}
            >
              Edit
            </Button>
          </li>
        ))}
      </ul>
      <Sheet open={open} onOpenChange={setOpen}>
        <SheetContent>
          <SheetHeader>
            <SheetTitle>Edit {run.id}</SheetTitle>
            <SheetDescription>Bench 3 · firmware 4.18.2 · 18 Nov, {run.time}</SheetDescription>
          </SheetHeader>
          <form key={run.id} onSubmit={save} className="flex flex-1 flex-col">
            <SheetBody>
              <Field>
                <FieldLabel>Run name</FieldLabel>
                <Input name="name" defaultValue={run.name} />
              </Field>
              <div className="grid grid-cols-2 gap-3">
                <NumberField
                  label="Kp"
                  defaultValue={run.kp}
                  min={0}
                  max={10}
                  step={0.05}
                  format={twoDecimals}
                />
                <NumberField
                  label="Kd"
                  defaultValue={run.kd}
                  min={0}
                  max={1}
                  step={0.01}
                  format={twoDecimals}
                />
              </div>
              <Field>
                <FieldLabel optional>Note</FieldLabel>
                <Textarea defaultValue={run.note} placeholder="What should reviewers look at?" />
              </Field>
            </SheetBody>
            <SheetFooter>
              <SheetClose render={<Button variant="ghost" />}>Cancel</SheetClose>
              <Button type="submit" variant="primary">
                Save changes
              </Button>
            </SheetFooter>
          </form>
        </SheetContent>
      </Sheet>
    </>
  );
}
```

## Used in

- App shell (template): https://ui.dtheo.dev/docs/components/app-shell
