Select
Allowing users to choose from a list of options. The component often appears as a popup menu where user clicks on the select button, to make a list of options appear.
Usage
Examples
Size
Use the size prop to change the select size! Available sizes are small, medium, and large. By default, the size is small.
Variant
Use the variant prop to change the variant select! Available variants are outline and ghost. By default, the variant is outline.
Disabled
There are many ways to interact with Select disabled state. Select can be disabled entirely by setting the disabled prop to true.
For a finer control on which option to disable, you can define disabled to individual SelectItem!
Disable the entire select
Disable individual options
Grouped Options
Grouped options can be created by using the SelectGroup and SelectGroupTitle components. It allows you to group related options together, creating a more organized and structured select.
With Header
You can add a header to the select by using the SelectHeader component. It allows you to add a header to the select, providing additional context, functionality or information to the user.
With Footer
You can add a footer to the select by using the SelectFooter component. It allows you to add a footer to the select, providing additional context, functionality or information to the user.
Multiple
Select also supports multiple selection. To enable multiple selection, set the multiple prop to true to Select.
Custom Value Display
You can customize the value display by using the SelectValue component. It allows you to customize the value display of the select.
Props
Select
| Prop | Type | Default |
|---|---|---|
multiple | boolean | false |
size | enum | small |
variant | enum | outline |
defaultValue | string | string[] | false |
value | string | string[] | false |
onValueChange | (date: Date ) => 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 |