Lewati ke konten

Combobox

Unduh .md

Combobox adalah kolom teks dengan daftar: orang mengetik untuk menyaring daftar, lalu memilih satu nilai dengan mouse atau keyboard.

  • Pakai untuk lebih dari 15 pilihan, atau saat orang tahu apa yang dicarinya, misalnya artis, lagu, atau perusahaan.
  • Pakai Select untuk 4 sampai 15 pilihan, dan Radio Group untuk 2 atau 3.
  • Tulis teks kosong untuk daftarnya, misalnya “Artis tidak ditemukan.”, supaya orang tahu pencariannya sudah jalan.

Mencari di server. Kalau daftarnya ada di backend, cari sambil orang mengetik: tunggu sekitar 300ms setelah ketikan terakhir, biarkan hasil sebelumnya tampil selama hasil berikutnya dimuat, dan tampilkan Spinner di daftar. Backend yang menentukan apa yang cocok.

React
Vue
1234
  1. 1Input untuk mengetik
  2. 2Teks yang diketik dan kursor
  3. 3Pilihan yang cocok
  4. 4Daftar
  1. Input: kolom teks dengan radius-md dan border input, tinggi h-9.
  2. Daftar: popup berlatar popover dengan border, radius-lg, dan shadow-lg, selebar input.
  3. Item: radius-md; item yang disorot berlatar accent dan yang terpilih bertanda centang.
  4. Teks kosong: tampil saat tidak ada yang cocok.

Hanya ada satu gaya. React juga punya chip (ComboboxChips) untuk memilih beberapa nilai.

React Vue Flutter Tipe Default Kegunaan
items di Combobox children ComboboxItem options di ShadSelect.withSearch list tidak ada Daftar pilihan.
value / defaultValue v-model initialValue nilai tidak ada Nilai terpilih.
onValueChange @update:model-value onChanged function tidak ada Jalan saat nilai dipilih.
placeholder di ComboboxInput placeholder di ComboboxInput placeholder teks tidak ada Tampil sebelum ada pilihan.
ComboboxEmpty ComboboxEmpty baris kosong di options teks tidak ada Memberi tahu bahwa tidak ada yang cocok.
onInputValueChange @update:model-value di ComboboxInput onSearchChanged function tidak ada Jalan saat orang mengetik, untuk pencarian di server.
import { useId } from "react"
import {
Combobox,
ComboboxContent,
ComboboxEmpty,
ComboboxInput,
ComboboxItem,
ComboboxList,
} from "@/components/ui/combobox"
import { Field, FieldLabel } from "@/components/ui/field"
const artists = ["Rara Senandika", "Bima Laras", "Nada Kirana", "Arka Wening", "Sinta Maharani", "Raka Pratama"]
export default function ComboboxDemo() {
const id = useId()
return (
<Field className="w-full max-w-xs">
<FieldLabel htmlFor={`${id}-artist`}>Artis</FieldLabel>
<Combobox items={artists}>
<ComboboxInput id={`${id}-artist`} placeholder="Pilih artis" />
<ComboboxContent>
<ComboboxEmpty>Artis tidak ditemukan.</ComboboxEmpty>
<ComboboxList>
{(artist: string) => (
<ComboboxItem key={artist} value={artist}>
{artist}
</ComboboxItem>
)}
</ComboboxList>
</ComboboxContent>
</Combobox>
</Field>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/combobox.json
  • Input punya role="combobox" dan label yang terlihat; daftarnya role="listbox" dan itemnya role="option".
  • Mengetik menyaring daftar. Tombol panah berpindah antaritem, Enter memilih, dan Escape menutup daftar tanpa mengubah nilai.
  • Teks kosong dibacakan saat tidak ada yang cocok.