Select
Displays a list of options for the user to pick from—triggered by a button.
import { Label } from "@ngrok/mantle/label";
import {
Select,
SelectContent,
SelectGroup,
SelectItem,
SelectLabel,
SelectSeparator,
SelectTrigger,
SelectValue,
} from "@ngrok/mantle/select";
Examples
Custom selected value
By default the selected item's text will be rendered when selected. Sometimes you may need to render something different. You can control the select and pass children
instead.
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@ngrok/mantle/select";
API Reference
The Select
components are built on top of Radix Select.
Select
Displays a list of options for the user to pick from—triggered by a button.
All props from Radix Select.Root, plus:
SelectTrigger
The button that toggles the Select
. The SelectContent
will position itself adjacent to the trigger.
All props from Radix Select.Trigger, plus:
SelectValue
The part that reflects the selected value. By default the selected item's text will be rendered. if you require more control, you can instead control the Select
and pass your own children. It should not be styled to ensure correct positioning. An optional placeholder prop is also available for when the Select
has no value.
Radix Select.Value props.
SelectContent
The component that pops out when the Select
is open as a portal adjacent to the SelectTrigger
button. It contains a scrolling viewport of the select items.
All props from Radix Select.Content, plus:
SelectGroup
A group of related options within a select menu. Similar to an html optgroup
element. Use in conjunction with SelectLabel
to ensure good accessibility via automatic labelling.
Radix Select.Group props.
SelectSeparator
Used to visually separate items in the select. Composed from Mantle Separator.
SelectItem
An option within a select menu. Similar to an html option
element. Has a required value
prop that will be passed to the onChange
handler of the Select
component when this item is selected. Displays the children as the option's text.
Radix Select.Item props.
SelectLabel
Used to render the label of a group. It won't be focusable using arrow keys. Use in conjunction with SelectGroup
to ensure good accessibility via automatic labelling of a group.
Radix Select.Label props.