# Badge

> Menampilkan status atau label singkat.

Badge menampilkan status sebuah item, misalnya rilisan atau dokumen, atau label singkat seperti "Baru".

## Kapan dipakai

- Pakai varian status untuk keadaan sebuah data: `success`, `warning`, `info`, `destructive`.
- Selalu tulis statusnya dengan kata. Warna saja tidak cukup untuk menyampaikan status.
- Pakai `default` atau `outline` untuk label yang bukan status.
- Jangan pakai badge sebagai tombol.

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

### Lakukan dan jangan

- **Lakukan:** Sebut statusnya dengan kata, dan warnanya sebagai tanda kedua.
- **Jangan:** Jangan tunjukkan status hanya dengan warna; tidak semua orang bisa membedakannya.

## Anatomi

1. Teks warna status
2. Latar lembut
3. Varian outline

Teks pendek `text-xs` medium dengan `radius-sm` (6px). Badge tidak pernah berbentuk pil. Badge status memakai isi lembut dari statusnya, dengan warna status sebagai teks.

## Varian

| Varian | Tampilan | Dipakai untuk |
| --- | --- | --- |
| `success` | Teks `success` di atas `success-soft` | Selesai, disetujui, terbit. |
| `warning` | Teks `warning` di atas `warning-soft` | Menunggu, sedang ditinjau. |
| `info` | Teks `info` di atas `info-soft` | Informasi netral. |
| `destructive` | Teks `destructive` di atas `destructive-soft` | Ditolak, gagal, dibatalkan. |
| `default` | Isi `primary` | Label berwarna produk, misalnya "Baru". |
| `secondary` | Isi `secondary` | Label yang tenang. |
| `outline` | Garis `border` | Label yang tidak perlu menonjol, misalnya "Draf". |
| `ghost` | Tanpa isi sampai di-hover | Label tenang di dalam link atau menu. |
| `link` | `primary-text`, bergaris bawah saat di-hover | Badge yang sekaligus link. |

Badge `default` di atas oranye Cover Clearance memakai pengecualian kontras yang sama dengan tombol utama. Buat labelnya singkat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | named constructor, atau `backgroundColor` + `foregroundColor` untuk status | lihat Varian | `default` | Makna dan bobot. |
| `render` | `as` / `as-child` | `child` | elemen | `span` | Merender badge sebagai elemen lain, misalnya link. |

## Kode

**React**
```tsx
import { Badge } from "@/components/ui/badge"

export default function BadgeDemo() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Badge variant="success">Selesai</Badge>
      <Badge variant="warning">Menunggu</Badge>
      <Badge variant="info">Info</Badge>
      <Badge variant="destructive">Ditolak</Badge>
      <Badge>Baru</Badge>
      <Badge variant="outline">Draf</Badge>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Badge } from "@/components/ui/badge"
</script>

<template>
  <div class="flex flex-wrap items-center gap-2">
    <Badge variant="success">Selesai</Badge>
    <Badge variant="warning">Menunggu</Badge>
    <Badge variant="info">Info</Badge>
    <Badge variant="destructive">Ditolak</Badge>
    <Badge>Baru</Badge>
    <Badge variant="outline">Draf</Badge>
  </div>
</template>
```

**Flutter**
```dart
// Status colors come from the Sosialoka theme: context.sosialoka.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

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

  ShadBadge status(Color text, Color soft, String label) =>
      ShadBadge(backgroundColor: soft, foregroundColor: text, child: Text(label));

  @override
  Widget build(BuildContext context) {
    final c = context.sosialoka;
    return Wrap(
      spacing: 8,
      runSpacing: 8,
      children: [
        status(c.success, c.successSoft, 'Selesai'),
        status(c.warning, c.warningSoft, 'Menunggu'),
        status(c.info, c.infoSoft, 'Info'),
        status(c.destructive, c.destructiveSoft, 'Ditolak'),
        const ShadBadge(child: Text('Baru')),
        const ShadBadge.outline(child: Text('Draf')),
      ],
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Teks badge dibacakan seperti teks biasa, jadi buat tetap bermakna tanpa warnanya.
- Warna status lolos kontras 4.5:1 di atas isi lembutnya, di semua tema.
