Komponen / Form & input
Combobox
Pilihan tunggal dengan pencarian untuk daftar panjang — customer, item lisensi, distributor — dengan aksi "Buat baru" opsional bila data belum ada.
Kapan dipakai
Gunakan
- Pakai untuk daftar lebih dari ±15 opsi atau data master yang terus bertambah: customer, item, distributor, proyek.
- Isi `description` untuk membedakan nama yang mirip (kota, NPWP singkat, kategori item).
- Aktifkan "Buat baru" hanya bila pengguna memang berhak membuat data itu; buka dialog singkat yang sudah terisi teks yang diketik.
- Tulis pesan kosong yang memberi langkah berikutnya: periksa ejaan atau buat data baru.
Hindari
- Jangan memakai Combobox untuk 2–15 opsi tetap (termin, status) — pakai Select atau Radio.
- Jangan menerima teks bebas sebagai nilai: yang tersimpan selalu value opsi, teks yang tidak cocok dikembalikan saat fokus keluar.
- Jangan memuat ribuan opsi sekaligus di klien — cari ke server lewat onInputChange + filter={false}.
Contoh benar & salah
Penulisan
- Placeholder berupa ajakan mencari dengan objeknya: "Cari customer…", "Cari lisensi atau jasa…".
- Label aksi buat baru menyebut objeknya: "Buat customer baru", `Buat customer "Cakra"`.
- Pesan kosong: `Tidak ada customer bernama "cakra". Periksa ejaan atau buat customer baru.`
- Baris meta "3 dari 128 customer" memakai kata benda yang sama dengan label field.
Komponen terkait
- SelectPop-up button untuk memilih satu dari daftar pendek.
- MultiSelectMemilih beberapa nilai, mis. assignee atau tag.
- SearchFieldKolom pencarian kapsul dengan tombol hapus.
- FormFieldLabel + kontrol + teks bantuan/error yang saling terhubung.
- PopoverPanel melayang untuk detail atau filter tanpa meninggalkan layar.