# Dialog

> Meminta keputusan atau isian di jendela di atas halaman.

Dialog meminta keputusan atau isian singkat di jendela di atas halaman, sementara halaman di belakangnya diredupkan.

## Kapan dipakai

- Pakai untuk form singkat atau pilihan yang butuh perhatian penuh, misalnya mengubah judul rilis.
- Pakai [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/) untuk memastikan aksi yang tidak bisa dibatalkan.
- Pakai [Toast](https://design.sosialoka.tech/id/components/toast/) untuk memberi tahu sesuatu yang sudah terjadi.
- Jangan menaruh alur panjang di dialog; pakai halaman.

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

### Lakukan dan jangan

- **Lakukan:** Batasi dialog untuk satu keputusan atau form pendek.
- **Jangan:** Jangan buka dialog di atas dialog lain.

## Anatomi

1. Overlay
2. Judul
3. Isi
4. Aksi, primary paling akhir

Judul, deskripsi, isi opsional, lalu aksi di footer. Jendelanya berlatar `popover` dengan garis `border`, `radius-xl` (16px), dan `shadow-lg`. Halaman di belakangnya diredupkan dengan token `overlay`.

## Varian

Hanya ada satu gaya. Taruh aksi utama paling akhir di footer.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `defaultOpen` | `v-model:open` / `default-open` | `showShadDialog` | boolean | `false` | Terbuka atau tidak. |
| `onOpenChange` | `@update:open` | nilai kembali `showShadDialog` | function | tidak ada | Jalan saat dibuka atau ditutup. |
| `DialogTrigger render` | `DialogTrigger as-child` | `onPressed` | elemen | button | Kontrol yang membukanya. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog"
import { Field, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"

export default function DialogDemo() {
  const id = useId()
  return (
    <Dialog>
      <DialogTrigger render={<Button variant="outline" />}>Ubah judul</DialogTrigger>
      <DialogContent>
        <DialogHeader>
          <DialogTitle>Ubah judul rilis</DialogTitle>
          <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription>
        </DialogHeader>
        <Field>
          <FieldLabel htmlFor={`${id}-title`}>Judul rilis</FieldLabel>
          <Input id={`${id}-title`} defaultValue="Senja di Kota" />
        </Field>
        <DialogFooter>
          <DialogClose render={<Button variant="outline" />}>Batal</DialogClose>
          <DialogClose render={<Button />}>Simpan</DialogClose>
        </DialogFooter>
      </DialogContent>
    </Dialog>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog"
import { Field, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"

const id = useId()
</script>

<template>
  <Dialog>
    <DialogTrigger as-child>
      <Button variant="outline">Ubah judul</Button>
    </DialogTrigger>
    <DialogContent>
      <DialogHeader>
        <DialogTitle>Ubah judul rilis</DialogTitle>
        <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription>
      </DialogHeader>
      <Field>
        <FieldLabel :for="`${id}-title`">Judul rilis</FieldLabel>
        <Input :id="`${id}-title`" default-value="Senja di Kota" />
      </Field>
      <DialogFooter>
        <DialogClose as-child><Button variant="outline">Batal</Button></DialogClose>
        <DialogClose as-child><Button>Simpan</Button></DialogClose>
      </DialogFooter>
    </DialogContent>
  </Dialog>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Ubah judul'),
      onPressed: () => showShadDialog(
        context: context,
        builder: (context) => ShadDialog(
          title: const Text('Ubah judul rilis'),
          description: const Text('Judul baru tampil di semua toko musik setelah dikirim ulang.'),
          actions: [
            ShadButton.outline(child: const Text('Batal'), onPressed: () => Navigator.of(context).pop()),
            ShadButton(child: const Text('Simpan'), onPressed: () => Navigator.of(context).pop()),
          ],
          child: ShadInputFormField(id: 'release-title', label: const Text('Judul rilis'), initialValue: 'Senja di Kota'),
        ),
      ),
    );
  }
}
```

## Pasang

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

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

Tombol yang ikut terpasang adalah tombol Sosialoka.

## Aksesibilitas

- Dirender dengan `role="dialog"` dan judul sebagai namanya. Fokus pindah ke dalam dialog, lalu kembali ke pemicunya saat ditutup.
- Escape menutupnya, dan fokus tetap di dalam selama dialog terbuka.
