# Alert Dialog

> Memastikan aksi yang tidak bisa dibatalkan.

Alert Dialog meminta orang memastikan aksi yang tidak bisa dibatalkan, misalnya menghapus rilis, sebelum aksinya jalan.

## Kapan dipakai

- Pakai hanya untuk aksi yang tidak bisa dibatalkan: menghapus, membatalkan langganan, menarik kontrak.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk form singkat, dan [Toast](https://design.sosialoka.tech/id/components/toast/) dengan tombol urungkan kalau aksinya bisa dikembalikan.
- Tulis judulnya sebagai pertanyaan ("Hapus rilis?") dan sebut apa yang hilang di deskripsinya.
- Beri tombol aksi kata kerjanya ("Hapus"), jangan "Ya" atau "OK".

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

### Lakukan dan jangan

- **Lakukan:** Sebut aksinya di judul dan di tombol, dan fokuskan Batal lebih dulu.
- **Jangan:** Jangan ajukan pertanyaan samar dengan satu tombol OK.

## Anatomi

1. Ikon peringatan
2. Judul yang menyebut aksinya
3. Batal, fokus pertama
4. Aksi destruktif

Judul, deskripsi, dan pita footer berisi **Batal** dan tombol aksi. Jendelanya berlatar `popover` dengan `border`, `radius-xl`, dan `shadow-lg`, di atas token `overlay`. Fokus awal ada di **Batal**, dan aksi destruktif ada paling kanan.

## Varian

Hanya ada satu gaya. Pakai tombol `destructive` untuk aksinya; tombol default hanya untuk aksi yang tidak menghapus, misalnya keluar dari semua perangkat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `onOpenChange` | `v-model:open` | `showShadDialog` | boolean | `false` | Membuka lewat kode. |
| `AlertDialogAction variant` | `AlertDialogAction variant` | `ShadButton.destructive` | teks | `default` | Tombol aksi. |
| `AlertDialogCancel autoFocus` | `AlertDialogCancel` (fokus pertama) | `ShadButton.outline(autofocus: true)` | boolean | tidak ada | Memulai fokus di Batal. |
| `AlertDialogTrigger render` | `AlertDialogTrigger as-child` | tombol yang memanggil `showShadDialog` | elemen | tidak ada | Tombol yang membukanya. |

## Kode

**React**
```tsx
import { useState } from "react"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
  AlertDialogTrigger,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"

export default function AlertDialogDemo() {
  const [deleted, setDeleted] = useState(false)
  if (deleted) return <p className="text-sm text-muted-foreground">"Senja di Kota" dihapus.</p>
  return (
    <AlertDialog>
      <AlertDialogTrigger render={<Button variant="outline" />}>Hapus rilis</AlertDialogTrigger>
      <AlertDialogContent>
        <AlertDialogHeader>
          <AlertDialogTitle>Hapus rilis?</AlertDialogTitle>
          <AlertDialogDescription>"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.</AlertDialogDescription>
        </AlertDialogHeader>
        <AlertDialogFooter>
          <AlertDialogCancel autoFocus>Batal</AlertDialogCancel>
          <AlertDialogAction variant="destructive" onClick={() => setDeleted(true)}>
            Hapus
          </AlertDialogAction>
        </AlertDialogFooter>
      </AlertDialogContent>
    </AlertDialog>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
  AlertDialogTrigger,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"

const deleted = ref(false)
</script>

<template>
  <p v-if="deleted" class="text-sm text-muted-foreground">"Senja di Kota" dihapus.</p>
  <AlertDialog v-else>
    <AlertDialogTrigger as-child>
      <Button variant="outline">Hapus rilis</Button>
    </AlertDialogTrigger>
    <AlertDialogContent>
      <AlertDialogHeader>
        <AlertDialogTitle>Hapus rilis?</AlertDialogTitle>
        <AlertDialogDescription>"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.</AlertDialogDescription>
      </AlertDialogHeader>
      <AlertDialogFooter>
        <AlertDialogCancel>Batal</AlertDialogCancel>
        <AlertDialogAction variant="destructive" @click="deleted = true">Hapus</AlertDialogAction>
      </AlertDialogFooter>
    </AlertDialogContent>
  </AlertDialog>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Hapus rilis'),
      onPressed: () => showShadDialog<bool>(
        context: context,
        builder: (context) => ShadDialog.alert(
          title: const Text('Hapus rilis?'),
          description: const Text('"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.'),
          actions: [
            // Cancel takes the focus first; the destructive action sits last.
            ShadButton.outline(autofocus: true, child: const Text('Batal'), onPressed: () => Navigator.of(context).pop(false)),
            ShadButton.destructive(child: const Text('Hapus'), onPressed: () => Navigator.of(context).pop(true)),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Punya `role="alertdialog"`, dinamai judulnya dan dijelaskan deskripsinya.
- Fokus awal di Batal, jadi menekan Enter karena kebiasaan tidak menghapus apa pun.
- Escape membatalkan; klik di luar tidak menutupnya.
- Fokus tetap di dalam sampai tertutup, lalu kembali ke pemicunya.
