Multi select — dir/ui
Select multiple values from a fixed list of options.
# Multi select
Select multiple values from a fixed list of options.
## Install
```sh
npx shadcn@4.21.0 add lr-run/dir-ui/multi-select#v0.1.2
```
[Registry item with source and dependencies](https://github.com/lr-run/dir-ui/blob/v0.1.2/registry.json)
Requires React 19, Tailwind CSS 4 and shadcn initialized with Base UI. Registry target placeholders resolve through components.json: @ui, @components, @hooks and @lib. Imports below use the conventional @/ prefix for illustration; the CLI rewrites them to your configured aliases. Shared components are installed once through registryDependencies. Theme CSS is imported by the UI modules. Existing files are never forcibly overwritten; review CLI conflicts before accepting changes. No Dir runtime is required.
## MultiSelect
```tsx
import { MultiSelect } from '@/components/ui/multi-select.tsx'
```
| Prop | Type | Default / required | Notes |
| --- | --- | --- | --- |
| items | Choice[] | Required | |
| value | string[] | Required | |
| onValueChange | (value: string[]) => void | Required | |
| label | string | Required | Accessible input name. |
| id | string | — | |
| disabled / invalid | boolean | false | |
| disabled | boolean | false | |
| aria-describedby | string | — | |
| open | boolean | Internal state | Control whether the option menu is open. |
| onOpenChange | (open: boolean) => void | — | |
```ts
type Choice = { value: string; label: string }
```