Pilih
Membenarkan pengguna memilih dari senarai pilihan. Komponen ini sering muncul sebagai menu pop timbul di mana pengguna mengklik butang pilih, untuk membuat senarai pilihan muncul.
Penggunaan
Contoh
Saiz
Gunakan prop size untuk menukar saiz pilihan! Saiz yang tersedia adalah small, medium, dan large. Secara lalai, saiz adalah small.
Varian
Gunakan prop variant untuk menukar varian pilihan! Varian yang tersedia adalah outline dan ghost. Secara lalai, varian adalah outline.
Dinonaktifkan
Terdapat banyak cara untuk berinteraksi dengan keadaan disabled Pilih. Select boleh dinonaktifkan sepenuhnya dengan menetapkan prop disabled kepada true.
Untuk kawalan yang lebih halus pada pilihan mana yang hendak dinonaktifkan, anda boleh menetapkan disabled pada SelectItem individu!
Nonaktifkan keseluruhan pilihan
Nonaktifkan pilihan individu
Pilihan Berkumpulan
Pilihan berkumpulan boleh dibuat dengan menggunakan komponen SelectGroup dan SelectGroupTitle. Ia membolehkan anda mengumpulkan pilihan yang berkaitan bersama-sama, mewujudkan pilihan yang lebih teratur dan berstruktur.
Dengan Header
Anda boleh menambah header pada pilihan dengan menggunakan komponen SelectHeader. Ia membolehkan anda menambah header pada pilihan, memberikan konteks tambahan, fungsi atau maklumat kepada pengguna.
Dengan Footer
Anda boleh menambah footer pada pilihan dengan menggunakan komponen SelectFooter. Ia membolehkan anda menambah footer pada pilihan, memberikan konteks tambahan, fungsi atau maklumat kepada pengguna.
Pelbagai
Pilih juga menyokong pemilihan berbilang. Untuk membolehkan pemilihan berbilang, tetapkan prop multiple kepada true pada Select.
Paparan Nilai Tersuai
Anda boleh menyesuaikan paparan nilai dengan menggunakan komponen SelectValue. Ia membolehkan anda menyesuaikan paparan nilai pilihan.
Props
Pilih
| Prop | Type | Default |
|---|---|---|
multiple | boolean | false |
size | enum | small |
variant | enum | outline |
defaultValue | string | string[] | false |
value | string | string[] | false |
onValueChange | (string | string[]) => void | - |
disabled | boolean | false |
SelectValue
| Prop | Type | Default |
|---|---|---|
label | string | - |
children | (value: string | string[]) => ReactNode | - |
placeholder | ReactNode | - |
SelectItem
| Prop | Type | Default |
|---|---|---|
value | string | string |
disabled | boolean | false |