Skip to contentKino
Skip to Content

Select

A select that opens over its trigger, with the picked option on the value, and unfolds out of the trigger's own outline.

npx shadcn add https://kinoui.com/r/select.json
Share on

Examples

Default

It opens over its trigger with the picked option on the value, and unfolds out of the trigger’s outline.

Groups

Group options under a label; a long list scrolls.

Multiple

With multiple, it stays open while you pick, and SelectValue takes a function for what the trigger shows.

Under the trigger

Set alignItemWithTrigger to false to open it under the trigger, where it grows as a Popover does.

New issues go to this team.

In a form

A label names it, name sends its value with the form, and a disabled option can’t be picked.

Installation

npx shadcn@latest add https://kinoui.com/r/select.json
Files
lib/reduce-motion.tslib/scroll.tslib/refs.tslib/resize.tslib/swap.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/cut.tsxcomponents/kino/separator.tsxlib/run-progress.tslib/highlight.tslib/menu.tsxcomponents/kino/input.tsxcomponents/kino/select.tsx
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Select

PropTypeDefaultDescription
items{ value, label }[]Record<string, ReactNode>NoneThe options’ labels, so SelectValue shows a label, not a value.
defaultValueValueValue[]nullNoneThe value at first, when you leave the state to the select.
valueValueValue[]nullNoneThe value, when you hold the state.
onValueChange(value, details) => voidNoneCalled when the value changes.
multiplebooleanfalseLets more than one option be picked; the value is then an array.

SelectTrigger

PropTypeDefaultDescription
size'default''sm''default'Its height; both follow the density.

SelectContent

PropTypeDefaultDescription
alignItemWithTriggerbooleantrueWhether it opens over the trigger with the picked option on the value. It opens under the trigger on touch, and when there is no room.
side'left''top''bottom''right''inline-start''inline-end''bottom'The side it opens on when it opens beside the trigger.
align'start''center''end''start'How it lines up with the trigger along that side.
sideOffsetnumberfunction6The gap between it and the trigger when it opens beside it, in pixels.
alignOffsetnumberfunction0How far it shifts along that side, in pixels.
classNamestringNoneGoes to the options’ list inside the box.

Accessibility

  • The trigger is a combobox and the list a listbox: arrow keys move through the options, Enter or Space picks one, and Escape closes it.
  • Typing a letter jumps to the next option that starts with it, open or closed.
  • Name it with a <label> and the trigger’s id, or with aria-label.
  • The picked option has a tick as well as a highlight, so its state never relies on colour.
  • When the system asks for less motion, it only fades.