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 |