# Button

> Menjalankan aksi, misalnya menyimpan form atau membuka dialog.

Tombol menjalankan aksi di halaman yang sedang dibuka. Kalau aksinya membawa orang ke halaman lain, pakai link.

## Kapan dipakai

- Pakai satu tombol `default` untuk aksi utama di form, kartu, atau dialog.
- Pakai `secondary` atau `outline` untuk aksi lain di sebelahnya.
- Pakai `ghost` di toolbar dan baris yang padat, dan `link` di dalam kalimat.
- Pakai `destructive` hanya untuk aksi yang menghapus atau membatalkan.
- Jangan pakai tombol untuk pindah halaman; pakai link.

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

### Lakukan dan jangan

- **Lakukan:** Pakai satu tombol default untuk aksi utama; aksi lain outline atau secondary.
- **Jangan:** Jangan beri dua aksi bobot yang sama; orang tidak tahu mana yang melanjutkan.

## Anatomi

1. Wadah, dengan radius kontrol
2. Label
3. Varian outline untuk aksi kedua

Tombol berisi label, dengan ikon opsional di depan atau di belakangnya. Sudutnya memakai radius kontrol (`radius-md`, 8px) dan tidak pernah berbentuk pil.

## Varian

| Varian | Tampilan | Dipakai untuk |
| --- | --- | --- |
| `default` | Isi `primary`, teks `primary-foreground` | Aksi utama. Satu per area. |
| `secondary` | Isi `secondary` | Aksi kedua yang lebih ringan. |
| `outline` | Garis `border` di atas `background` | Aksi netral di samping aksi utama. |
| `ghost` | Tanpa isi sampai di-hover | Toolbar, baris tabel, tombol ikon. |
| `destructive` | Teks `destructive` di atas isi destructive yang lembut | Hapus, tolak, atau batalkan. |
| `link` | Teks `primary`, bergaris bawah saat di-hover | Aksi di dalam kalimat. |

Ukuran: `xs`, `sm`, `default`, `lg`, serta `icon`, `icon-xs`, `icon-sm`, `icon-lg` yang persegi untuk tombol berisi ikon saja.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | named constructor (`ShadButton.outline`) | lihat Varian | `default` | Bobot visual. |
| `size` | `size` | `size` (`ShadButtonSize`) | lihat Varian | `default` | Tinggi dan padding. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan aksi. |
| `onClick` | `@click` | `onPressed` | function | tidak ada | Menjalankan aksi. |

## Kode

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

export default function ButtonDemo() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Button>Simpan</Button>
      <Button variant="secondary">Simpan draf</Button>
      <Button variant="outline">Lihat detail</Button>
      <Button variant="ghost">Batal</Button>
      <Button variant="destructive">Hapus</Button>
      <Button variant="link">Pelajari lebih lanjut</Button>
    </div>
  )
}
```

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

<template>
  <div class="flex flex-wrap items-center gap-2">
    <Button>Simpan</Button>
    <Button variant="secondary">Simpan draf</Button>
    <Button variant="outline">Lihat detail</Button>
    <Button variant="ghost">Batal</Button>
    <Button variant="destructive">Hapus</Button>
    <Button variant="link">Pelajari lebih lanjut</Button>
  </div>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    return Wrap(
      spacing: 8,
      runSpacing: 8,
      children: [
        ShadButton(onPressed: () {}, child: const Text('Simpan')),
        ShadButton.secondary(onPressed: () {}, child: const Text('Simpan draf')),
        ShadButton.outline(onPressed: () {}, child: const Text('Lihat detail')),
        ShadButton.ghost(onPressed: () {}, child: const Text('Batal')),
        ShadButton.destructive(onPressed: () {}, child: const Text('Hapus')),
        ShadButton.link(onPressed: () {}, child: const Text('Pelajari lebih lanjut')),
      ],
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Dirender sebagai `button` asli, jadi bisa ditekan dengan Enter dan Spasi.
- Setiap tombol berisi ikon saja wajib punya `aria-label`.
- Cincin fokus memakai `ring` dan hanya muncul saat fokus keyboard.
- Label cukup menyebut aksinya: "Simpan", bukan "Klik di sini".
