# Checkbox

> Menyalakan atau mematikan satu pilihan.

Checkbox menyalakan atau mematikan satu pilihan, atau memilih beberapa pilihan dari daftar.

## Kapan dipakai

- Pakai untuk persetujuan dan untuk memilih beberapa item.
- Pakai radio group atau [Select](https://design.sosialoka.tech/id/components/select/) kalau hanya boleh satu pilihan.
- Jangan pakai untuk pengaturan yang langsung berlaku; pakai switch.

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

## Anatomi

1. Kotak tercentang di primary
2. Kotak belum dicentang
3. Label, ikut bisa diklik

Kotak 16px dengan `radius-sm` (6px) dan ikon centang, dengan label di sampingnya. Kotak yang dicentang terisi `primary`.

## Varian

Hanya ada satu gaya. Checkbox bisa tercentang, tidak tercentang, atau sebagian (indeterminate).

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `checked` / `defaultChecked` | `v-model` / `default-value` | `value` | boolean | `false` | Status. |
| `onCheckedChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat status berubah. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan perubahan. |
| `id` | `id` | `label` | string | tidak ada | Menghubungkan label. |

## Kode

**React**
```tsx
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"

export default function CheckboxDemo() {
  return (
    <div className="flex items-center gap-2">
      <Checkbox id="checkbox-demo-terms" />
      <Label htmlFor="checkbox-demo-terms">Saya setuju dengan syarat penggunaan</Label>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
</script>

<template>
  <div class="flex items-center gap-2">
    <Checkbox id="checkbox-demo-terms-vue" />
    <Label for="checkbox-demo-terms-vue">Saya setuju dengan syarat penggunaan</Label>
  </div>
</template>
```

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

class CheckboxDemo extends StatefulWidget {
  const CheckboxDemo({super.key});

  @override
  State<CheckboxDemo> createState() => _CheckboxDemoState();
}

class _CheckboxDemoState extends State<CheckboxDemo> {
  bool agreed = false;

  @override
  Widget build(BuildContext context) {
    return ShadCheckbox(
      value: agreed,
      onChanged: (value) => setState(() => agreed = value),
      label: const Text('Saya setuju dengan syarat penggunaan'),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Dirender dengan `role="checkbox"` dan `aria-checked`. Spasi mengubah statusnya.
- Setiap checkbox wajib punya label yang terhubung lewat `id`.
