# Alert

> Menampilkan pesan yang menetap di halaman, dengan warna status.

Alert menampilkan pesan yang menetap di halaman sampai penyebabnya selesai, misalnya rilis yang ditolak atau langganan yang hampir habis.

## Kapan dipakai

- Pakai untuk keadaan halaman atau akun yang perlu terlihat selama orang bekerja.
- Pakai [Toast](https://design.sosialoka.tech/id/components/toast/) untuk memberi tahu aksi yang baru saja terjadi; toast hilang sendiri.
- Tampilkan error validasi di bawah field-nya dengan [Field](https://design.sosialoka.tech/id/components/field/), bukan di alert. Form boleh menambahkan satu alert `destructive` di atas saat backend menolak seluruh form.
- Tulis judul singkat dan satu kalimat yang menyebut apa yang perlu dilakukan.

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

## Anatomi

1. Wadah berwarna status lembut
2. Ikon
3. Judul
4. Deskripsi

Ikon di kiri, judul, dan deskripsi, dengan `radius-lg` dan `px-4 py-3`. Varian status memakai permukaan status yang lembut, dengan ikon dan judul berwarna status dan deskripsi `foreground`; `default` memakai `card` dengan `border`.

## Varian

| Varian | Pakai untuk |
| --- | --- |
| `default` | Kabar netral, misalnya laporan yang sudah siap. |
| `info` | Hal yang perlu diketahui, misalnya rilis yang dijadwalkan. |
| `success` | Keadaan yang berhasil, misalnya rilis yang terkirim. |
| `warning` | Hal yang perlu segera diperhatikan, misalnya langganan yang hampir habis. |
| `destructive` | Sesuatu yang gagal atau ditolak, misalnya rilis yang ditolak. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | `ShadAlert` / `ShadAlert.destructive`, warna status dari `context.sosialoka` | teks | `default` | Statusnya. |
| `AlertTitle` | `AlertTitle` | `title` | teks | tidak ada | Judul singkat. |
| `AlertDescription` | `AlertDescription` | `description` | teks | tidak ada | Satu kalimat tentang apa yang perlu dilakukan. |
| ikon sebagai anak pertama | ikon sebagai anak pertama | `icon` | elemen | tidak ada | Ikon Lucide untuk statusnya. |

## Kode

**React**
```tsx
import { CircleAlertIcon, CircleCheckIcon, InfoIcon, TriangleAlertIcon, type LucideIcon } from "lucide-react"
import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert"

const alerts: { variant: "default" | "info" | "success" | "warning" | "destructive"; icon: LucideIcon; title: string; description: string }[] = [
  { variant: "default", icon: InfoIcon, title: "Laporan bulan ini sudah siap", description: "Kamu bisa mengunduhnya dari menu Royalti." },
  { variant: "info", icon: InfoIcon, title: "Rilis dijadwalkan", description: "\"Senja di Kota\" tayang 1 Des 2026 pukul 00.00 WIB." },
  { variant: "success", icon: CircleCheckIcon, title: "Rilis terkirim", description: "Semua toko musik sudah menerima \"Kaset Pertama\"." },
  { variant: "warning", icon: TriangleAlertIcon, title: "Langgananmu hampir habis", description: "Masa langgananmu habis 3 hari lagi." },
  { variant: "destructive", icon: CircleAlertIcon, title: "Rilis ditolak", description: "Sampulnya belum sesuai aturan toko musik." },
]

export default function AlertDemo() {
  return (
    <div className="grid w-full max-w-md gap-3">
      {alerts.map(({ variant, icon: Icon, title, description }) => (
        <Alert key={variant} variant={variant}>
          <Icon />
          <AlertTitle>{title}</AlertTitle>
          <AlertDescription>{description}</AlertDescription>
        </Alert>
      ))}
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { CircleAlertIcon, CircleCheckIcon, InfoIcon, TriangleAlertIcon } from "@lucide/vue"
import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert"

const alerts = [
  { variant: "default", icon: InfoIcon, title: "Laporan bulan ini sudah siap", description: "Kamu bisa mengunduhnya dari menu Royalti." },
  { variant: "info", icon: InfoIcon, title: "Rilis dijadwalkan", description: "\"Senja di Kota\" tayang 1 Des 2026 pukul 00.00 WIB." },
  { variant: "success", icon: CircleCheckIcon, title: "Rilis terkirim", description: "Semua toko musik sudah menerima \"Kaset Pertama\"." },
  { variant: "warning", icon: TriangleAlertIcon, title: "Langgananmu hampir habis", description: "Masa langgananmu habis 3 hari lagi." },
  { variant: "destructive", icon: CircleAlertIcon, title: "Rilis ditolak", description: "Sampulnya belum sesuai aturan toko musik." },
] as const
</script>

<template>
  <div class="grid w-full max-w-md gap-3">
    <Alert v-for="a in alerts" :key="a.variant" :variant="a.variant">
      <component :is="a.icon" />
      <AlertTitle>{{ a.title }}</AlertTitle>
      <AlertDescription>{{ a.description }}</AlertDescription>
    </Alert>
  </div>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    final c = context.sosialoka;
    final theme = ShadTheme.of(context);
    // Status alerts: the soft status surface, the icon and title in the status color.
    ShadAlert status(Color color, Color soft, IconData icon, String title, String description) => ShadAlert(
          icon: Icon(icon),
          iconColor: color,
          title: Text(title),
          titleStyle: theme.textTheme.p.copyWith(color: color, fontWeight: FontWeight.w500),
          description: Text(description),
          decoration: ShadDecoration(color: soft, border: ShadBorder.none),
        );
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        spacing: 12,
        children: [
          const ShadAlert(
            icon: Icon(LucideIcons.info),
            title: Text('Laporan bulan ini sudah siap'),
            description: Text('Kamu bisa mengunduhnya dari menu Royalti.'),
          ),
          status(c.info, c.infoSoft, LucideIcons.info, 'Rilis dijadwalkan', '"Senja di Kota" tayang 1 Des 2026 pukul 00.00 WIB.'),
          status(c.success, c.successSoft, LucideIcons.circleCheck, 'Rilis terkirim', 'Semua toko musik sudah menerima "Kaset Pertama".'),
          status(c.warning, c.warningSoft, LucideIcons.triangleAlert, 'Langgananmu hampir habis', 'Masa langgananmu habis 3 hari lagi.'),
          status(c.destructive, c.destructiveSoft, LucideIcons.circleAlert, 'Rilis ditolak', 'Sampulnya belum sesuai aturan toko musik.'),
        ],
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Punya `role="alert"`, jadi pembaca layar membacakannya saat muncul. Render alert yang sudah ada sejak awal bersama halamannya, supaya tidak dibacakan ulang setiap ada perubahan.
- Statusnya juga tertulis di judul, tidak hanya lewat warna.
- Ikonnya dekoratif.
