Kanshō/Select

Select

Single-choice dropdown. Click outside or press Escape to dismiss. Options can carry a short description and a disabled flag.

Included in the single kansho full pack. Components are not offered as separate installs.

With description rows

Choose to enable data residency.

Component documentation

Select

components/inputs/select.tsx

Purpose

Provides a styled single-value select with optional option descriptions.

Appropriate use

Use for a bounded list when search is unnecessary and one option may be chosen.

Example

components/inputs/select.tsx has a representative live example in the "With description rows" section on /components/select.

States

Supports selected or placeholder state, disabled control or options, sm and md size, option descriptions, and field status.

API and props

Select accepts value, onValueChange, options, placeholder, status, size, id, ARIA labelling props, className, and disabled.

Dependencies

React, Radix Select, Lucide icons, Field, and the Kansho cn utility.

Accessibility

Radix supplies select keyboard and popup semantics; labelling, description, and invalid attributes are forwarded to the trigger.

Limitations

It selects one provided string value and does not support search, custom values, or native mobile select UI.

Source

Source: components/inputs/select.tsx.

Full pack

components/inputs/select.tsx is documented at /components/select and installs only through the single Kansho full pack; no individual component install is offered.