# Sheet

> Panel yang bergeser masuk dari tepi layar.

Sheet menggeser panel masuk dari tepi layar, di atas halaman yang diredupkan, untuk filter atau detail yang tidak butuh halaman baru.

## Kapan dipakai

- Pakai untuk filter di daftar, dan panel samping berisi detail satu baris.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk keputusan atau form singkat, dan halaman untuk alur panjang.
- Di HP, buka dari bawah sebagai bottom sheet.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/sheet/_

## Anatomi

1. Overlay
2. Panel dari tepi
3. Judul
4. Aksi

Header berisi judul dan satu kalimat deskripsi, isi, lalu footer berisi aksi utama. Panelnya berlatar `popover` dengan `border` di tepi dalam dan tanpa radius di tepi yang menempel ke layar, di atas token `overlay`.

## Varian

| Sisi | Pakai untuk |
| --- | --- |
| `right` (bawaan) | Filter dan detail di web. |
| `bottom` | Filter dan aksi di HP. |
| `left` / `top` | Jarang; menu navigasi memakai Sidebar. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `side` di `SheetContent` | `side` di `SheetContent` | `side` di `showShadSheet` | teks | `right` | Tepi asal panel. |
| `open` / `onOpenChange` | `v-model:open` | `showShadSheet` | boolean | `false` | Membuka lewat kode. |
| `SheetTitle`, `SheetDescription` | `SheetTitle`, `SheetDescription` | `title`, `description` | teks | tidak ada | Nama panel. |
| `SheetFooter` | `SheetFooter` | `actions` | elemen | tidak ada | Aksi utama. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet"

const statuses = ["Terbit", "Menunggu", "Ditolak"]

export default function SheetDemo() {
  const id = useId()
  return (
    <Sheet>
      <SheetTrigger render={<Button variant="outline" />}>Filter</SheetTrigger>
      <SheetContent side="right">
        <SheetHeader>
          <SheetTitle>Filter rilis</SheetTitle>
          <SheetDescription>Tampilkan rilis dengan status yang kamu pilih.</SheetDescription>
        </SheetHeader>
        <div className="grid gap-3 px-4">
          {statuses.map((status) => (
            <div key={status} className="flex items-center gap-2">
              <Checkbox id={`${id}-${status}`} />
              <Label htmlFor={`${id}-${status}`}>{status}</Label>
            </div>
          ))}
        </div>
        <SheetFooter>
          <SheetClose render={<Button />}>Terapkan</SheetClose>
        </SheetFooter>
      </SheetContent>
    </Sheet>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet"

const statuses = ["Terbit", "Menunggu", "Ditolak"]
const id = useId()
</script>

<template>
  <Sheet>
    <SheetTrigger as-child>
      <Button variant="outline">Filter</Button>
    </SheetTrigger>
    <SheetContent side="right">
      <SheetHeader>
        <SheetTitle>Filter rilis</SheetTitle>
        <SheetDescription>Tampilkan rilis dengan status yang kamu pilih.</SheetDescription>
      </SheetHeader>
      <div class="grid gap-3 px-4">
        <div v-for="status in statuses" :key="status" class="flex items-center gap-2">
          <Checkbox :id="`${id}-${status}`" />
          <Label :for="`${id}-${status}`">{{ status }}</Label>
        </div>
      </div>
      <SheetFooter>
        <SheetClose as-child>
          <Button>Terapkan</Button>
        </SheetClose>
      </SheetFooter>
    </SheetContent>
  </Sheet>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const statuses = ['Terbit', 'Menunggu', 'Ditolak'];

class SheetDemo extends StatelessWidget {
  const SheetDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Filter'),
      onPressed: () => showShadSheet(
        context: context,
        side: ShadSheetSide.right,
        builder: (context) => ShadSheet(
          constraints: const BoxConstraints(maxWidth: 384),
          title: const Text('Filter rilis'),
          description: const Text('Tampilkan rilis dengan status yang kamu pilih.'),
          actions: [ShadButton(child: const Text('Terapkan'), onPressed: () => Navigator.of(context).pop())],
          child: Column(
            mainAxisSize: MainAxisSize.min,
            crossAxisAlignment: CrossAxisAlignment.start,
            spacing: 12,
            children: [for (final status in statuses) ShadCheckbox(value: false, label: Text(status), onChanged: (_) {})],
          ),
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/sheet.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/sheet.json
```

## Aksesibilitas

- Sheet berupa dialog yang dinamai judulnya; fokus masuk ke dalamnya dan kembali ke pemicu saat tertutup.
- Escape dan tombol tutup menutupnya.
- Halaman di belakangnya tidak bisa dijangkau sampai sheet tertutup.
