# Komponen

> Komponen Sosialoka untuk React dan Vue, dipasang dari registry Sosialoka dengan CLI shadcn.

Komponen Sosialoka adalah komponen shadcn yang sudah membawa token, radius, dan warna status Sosialoka, untuk React dan Vue.

Komponen React dibangun di atas Base UI dan dipasang dengan `shadcn`. Komponen Vue dibangun di atas Reka UI dan dipasang dengan `shadcn-vue`. Keduanya menyalin kode sumber ke proyekmu, jadi kodenya milikmu.

## Siapkan proyek

Pasang tema produkmu dulu, lalu komponen yang kamu butuhkan. Langkah untuk React dan Vue ada di [Web](https://design.sosialoka.tech/id/web/#siapkan-proyek-shadcn); satu komponen dipasang seperti ini:

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

Untuk Flutter, siapkan paket `sosialoka_ui` di [Flutter](https://design.sosialoka.tech/id/flutter/) lalu salin kode dari tab Flutter di setiap komponen.

## Komponen

### Aksi

| Komponen | Untuk |
| --- | --- |
| [Button](https://design.sosialoka.tech/id/components/button/) | Menjalankan aksi. |
| [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/) | Beberapa aksi di balik satu tombol. |
| [Command](https://design.sosialoka.tech/id/components/command/) | Pencarian dari keyboard, dan kartu pencarian di header. |

### Formulir

| Komponen | Untuk |
| --- | --- |
| [Input](https://design.sosialoka.tech/id/components/input/) | Satu baris teks. |
| [Input Group](https://design.sosialoka.tech/id/components/input-group/) | Input dengan ikon, teks, atau tombol yang menempel, misalnya pencarian atau kata sandi. |
| [Textarea](https://design.sosialoka.tech/id/components/textarea/) | Teks beberapa baris. |
| [Label](https://design.sosialoka.tech/id/components/label/) | Memberi nama kontrol form. |
| [Field](https://design.sosialoka.tech/id/components/field/) | Label, hint, dan error dari backend di sekitar satu kontrol. |
| [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) | Menyalakan atau mematikan satu pilihan. |
| [Radio Group](https://design.sosialoka.tech/id/components/radio-group/) | Memilih satu dari beberapa pilihan yang terlihat. |
| [Switch](https://design.sosialoka.tech/id/components/switch/) | Pengaturan yang langsung berlaku. |
| [Slider](https://design.sosialoka.tech/id/components/slider/) | Memilih nilai atau rentang di sebuah lintasan, misalnya potongan preview. |
| [Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/) | Chip filter di atas daftar, misalnya status. |
| [Select](https://design.sosialoka.tech/id/components/select/) | Memilih satu nilai dari daftar pendek. |
| [Combobox](https://design.sosialoka.tech/id/components/combobox/) | Memilih dari daftar panjang dengan mengetik. |
| [Calendar](https://design.sosialoka.tech/id/components/calendar/) | Satu bulan untuk memilih hari, langsung di halaman. |
| [Date Picker](https://design.sosialoka.tech/id/components/date-picker/) | Kolom tanggal yang membuka kalender. |
| [Input OTP](https://design.sosialoka.tech/id/components/input-otp/) | Kode sekali pakai di enam kotak. |
| [File Upload](https://design.sosialoka.tech/id/components/file-upload/) | Menarik atau memilih file, dengan ukuran dan progresnya. |

### Tampilan

| Komponen | Untuk |
| --- | --- |
| [Badge](https://design.sosialoka.tech/id/components/badge/) | Menampilkan status atau label singkat. |
| [Alert](https://design.sosialoka.tech/id/components/alert/) | Pesan yang menetap di halaman, dengan warna status. |
| [Card](https://design.sosialoka.tech/id/components/card/) | Mengelompokkan isi di permukaannya sendiri. |
| [Carousel](https://design.sosialoka.tech/id/components/carousel/) | Deretan kartu yang bisa digeser, misalnya rilis terbaru. |
| [Item](https://design.sosialoka.tech/id/components/item/) | Baris daftar di HP dan di panel. |
| [Accordion](https://design.sosialoka.tech/id/components/accordion/) | Bagian yang terbuka satu per satu. |
| [Separator](https://design.sosialoka.tech/id/components/separator/) | Garis tipis di antara kelompok. |
| [Avatar](https://design.sosialoka.tech/id/components/avatar/) | Orang atau artis sebagai foto atau inisial. |
| [Timeline](https://design.sosialoka.tech/id/components/timeline/) | Apa saja yang terjadi pada sebuah data, terbaru di atas. |

### Navigasi

| Komponen | Untuk |
| --- | --- |
| [Tabs](https://design.sosialoka.tech/id/components/tabs/) | Berpindah antartampilan dari isi yang sama. |
| [Breadcrumb](https://design.sosialoka.tech/id/components/breadcrumb/) | Jalur kembali dari halaman yang dalam. |
| [Stepper](https://design.sosialoka.tech/id/components/stepper/) | Langkah-langkah alur dan posisimu. |
| [Sidebar](https://design.sosialoka.tech/id/components/sidebar/) | Navigasi utama dasbor. |

### Data

| Komponen | Untuk |
| --- | --- |
| [Table](https://design.sosialoka.tech/id/components/table/) | Data dalam baris dan kolom, dengan paginasi. |
| [Chart](https://design.sosialoka.tech/id/components/chart/) | Angka dari waktu ke waktu atau antarkategori, dengan tabel berisi angka yang sama. |

### Lapisan

| Komponen | Untuk |
| --- | --- |
| [Dialog](https://design.sosialoka.tech/id/components/dialog/) | Keputusan atau form singkat di atas halaman. |
| [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/) | Memastikan aksi yang tidak bisa dibatalkan. |
| [Sheet](https://design.sosialoka.tech/id/components/sheet/) | Filter atau detail di panel dari tepi layar. |
| [Drawer](https://design.sosialoka.tech/id/components/drawer/) | Bottom sheet di HP. |
| [Popover](https://design.sosialoka.tech/id/components/popover/) | Konten tambahan atau tugas singkat di samping pemicunya. |
| [Tooltip](https://design.sosialoka.tech/id/components/tooltip/) | Memberi nama kontrol berisi ikon saja. |

### Umpan balik

| Komponen | Untuk |
| --- | --- |
| [Toast](https://design.sosialoka.tech/id/components/toast/) | Memberi tahu aksi yang berhasil. |
| [Progress](https://design.sosialoka.tech/id/components/progress/) | Kemajuan unggahan atau impor. |
| [Spinner](https://design.sosialoka.tech/id/components/spinner/) | Tunggu sebentar, atau tombol yang sedang menyimpan. |
| [Skeleton](https://design.sosialoka.tech/id/components/skeleton/) | Placeholder selama konten dimuat. |

## Item pendukung

Beberapa komponen ikut memasang item Sosialoka yang lebih kecil: `toggle` ikut bersama Toggle Group, `pagination` bersama Table, `native-select` bersama Calendar Vue (untuk pemilih bulan dan tahunnya), dan komponen React memakai hook `use-mobile`. Semuanya mengikuti token yang sama, jadi bisa juga dipakai sendiri.
