# Toast

> Memberi tahu bahwa sebuah aksi berhasil, lewat pesan singkat yang hilang sendiri.

Toast memberi tahu bahwa sesuatu sudah terjadi, misalnya tersimpan atau terkirim, lewat pesan singkat yang hilang sendiri.

## Kapan dipakai

- Pakai untuk memastikan aksi yang baru dilakukan: "Rilis tersimpan."
- Pakai untuk error yang tidak terkait satu kolom: "Belum bisa mengirim. Coba lagi sebentar."
- Error validasi ditampilkan di bawah kolomnya, bukan di toast. Pesannya datang dari backend.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) kalau orang harus memutuskan sesuatu.

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

### Lakukan dan jangan

- **Lakukan:** Konfirmasi apa yang baru terjadi dalam beberapa kata.
- **Jangan:** Jangan taruh error, teks panjang, atau keputusan di toast; toast menutup sendiri.

## Anatomi

1. Ikon status
2. Pesan
3. Tutup

Pesan berlatar `popover` dengan garis `border`, `radius-lg`, dan `shadow-lg`, dengan ikon berwarna status: `success`, `info`, `warning`, atau `destructive`. Toast bertumpuk di salah satu sudut dan mengikuti mode halaman.

## Varian

`toast()` untuk pesan biasa, dan `toast.success`, `toast.info`, `toast.warning`, `toast.error` untuk pesan dengan ikon status.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `toast.success(pesan)` dari `sonner` | `toast.success(pesan)` dari `vue-sonner` | `ShadToaster.of(context).show(ShadToast(...))` | function | tidak ada | Menampilkan toast. |
| `<Toaster />` sekali di aplikasi | `<Toaster />` sekali di aplikasi | `ShadToaster` (di `ShadApp`) | elemen | tidak ada | Tempat toast muncul. |
| `position` di `Toaster` | `position` di `Toaster` | `alignment` | string | `bottom-right` | Sudut layar. |

`Toaster` Sosialoka membaca mode terang atau gelap dari `data-theme` atau class `.dark` di `<html>`, jadi tidak butuh theme provider.

## Kode

**React**
```tsx
import { toast } from "sonner"
import { Button } from "@/components/ui/button"
import { Toaster } from "@/components/ui/sonner"

export default function SonnerDemo() {
  return (
    <div className="flex flex-wrap gap-2">
      <Button variant="outline" onClick={() => toast.success("Rilis tersimpan.")}>
        Simpan
      </Button>
      <Button variant="outline" onClick={() => toast.error("Belum bisa mengirim. Coba lagi sebentar.")}>
        Kirim
      </Button>
      <Toaster />
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { toast } from "vue-sonner"
import { Button } from "@/components/ui/button"
import { Toaster } from "@/components/ui/sonner"
</script>

<template>
  <div class="flex flex-wrap gap-2">
    <Button variant="outline" @click="toast.success('Rilis tersimpan.')">Simpan</Button>
    <Button variant="outline" @click="toast.error('Belum bisa mengirim. Coba lagi sebentar.')">Kirim</Button>
    <Toaster />
  </div>
</template>
```

**Flutter**
```dart
// ShadApp already wraps the app in a ShadToaster.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

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

  @override
  Widget build(BuildContext context) {
    return Wrap(
      spacing: 8,
      children: [
        ShadButton.outline(
          child: const Text('Simpan'),
          onPressed: () => ShadToaster.of(context).show(const ShadToast(description: Text('Rilis tersimpan.'))),
        ),
        ShadButton.outline(
          child: const Text('Kirim'),
          onPressed: () => ShadToaster.of(context).show(
            const ShadToast.destructive(description: Text('Belum bisa mengirim. Coba lagi sebentar.')),
          ),
        ),
      ],
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Toast dibacakan screen reader tanpa mengambil fokus.
- Buat singkat. Apa pun yang harus ditindaklanjuti ditaruh di halaman atau dialog.
