Select
Select component is a component that allows users pick a value from predefined options. Ideally, it should be used when there are more than 5 options, otherwise you might consider using a radio group instead.
Import
import { Select } from '@chakra-ui/react';
Usage
The Select components is used when there are more than 5 options for users to pick from, otherwise consider using a radio group instead.
Here is a basic usage of the Select
component.
Changing the size
The Select
component comes in four sizes. The default is md
.
xs
(24px
)sm
(32px
)md
(40px
)lg
(48px
)
Changing the appearance
Just like the input component, Select
comes in 4 variants, outline
,
unstyled
, flushed
, and filled
. Pass the variant
prop and set it to
either of these values.
Changing the icon
As with most Chakra components, you can change the arrow icon used in the
select. Simply pass the icon
prop.
In case the custom icon size doesn't look right, you can pass the iconSize
prop to change it.
Overriding the styles
Even though the select comes with predefined styles, you can override pretty much any property. Here we'll override the background color.
Props
The Select component composes Box so you can pass
all Box
props, and native Select
props in addition to these:
colorScheme
colorScheme
Color Schemes for Select
are not implemented in the default theme. You can extend the theme to implement them.
string
errorBorderColor
errorBorderColor
The border color when the select is invalid. Use color keys in `theme.colors` @example errorBorderColor = "red.500"
string
focusBorderColor
focusBorderColor
The border color when the select is focused. Use color keys in `theme.colors` @example focusBorderColor = "blue.500"
string
icon
icon
The icon element to use in the select
React.ReactElement
iconColor
iconColor
The color of the icon
string
iconSize
iconSize
The size (width and height) of the icon
string
isDisabled
isDisabled
boolean
isInvalid
isInvalid
If true
, the form control will be invalid. This has 2 side effects:
- The FormLabel
and FormErrorIcon
will have `data-invalid` set to true
- The form element (e.g, Input) will have `aria-invalid` set to true
boolean
isReadOnly
isReadOnly
If true
, the form control will be readonly
boolean
isRequired
isRequired
If true
, the form control will be required. This has 2 side effects:
- The FormLabel
will show a required indicator
- The form element (e.g, Input) will have `aria-required` set to true
boolean
rootProps
rootProps
Props to forward to the root div
element
RootProps
size
size
"lg" | "md" | "sm" | "xs"
"md"
variant
variant
"outline" | "filled" | "flushed" | "unstyled"
"outline"