Checkbox
Checkbox menyalakan atau mematikan satu pilihan, atau memilih beberapa pilihan dari daftar.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk persetujuan dan untuk memilih beberapa item.
- Pakai radio group atau Select kalau hanya boleh satu pilihan.
- Jangan pakai untuk pengaturan yang langsung berlaku; pakai switch.
Anatomi
Section titled “Anatomi”- 1Kotak tercentang di primary
- 2Kotak belum dicentang
- 3Label, ikut bisa diklik
Kotak 16px dengan radius-sm (6px) dan ikon centang, dengan label di sampingnya. Kotak yang dicentang terisi primary.
Varian
Section titled “Varian”Hanya ada satu gaya. Checkbox bisa tercentang, tidak tercentang, atau sebagian (indeterminate).
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/checkbox.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/checkbox.jsonAksesibilitas
Section titled “Aksesibilitas”- Dirender dengan
role="checkbox"danaria-checked. Spasi mengubah statusnya. - Setiap checkbox wajib punya label yang terhubung lewat
id.
