MultiSelect 多选

业务组件

在弹出面板中选择多个选项,支持标签形式展示已选项。

何时使用

从预设选项中选择多个值。

tsx

import { MultiSelect } from "@/components/business/multi-select"

export function Basic() {
return <MultiSelect />
}

tsx

<MultiSelect>Normal</MultiSelect>
<MultiSelect disabled>Disabled</MultiSelect>

Prop	Type	Default	说明
`className`	`string`	—	自定义样式类名
`options`	`MultiSelectOption[]`	—	可选项列表
`value`	`string[]`	—	当前值(受控)
`onChange`	`() => void`	—	值变化回调
`placeholder`	`string`	`Select...`	占位文本
`searchPlaceholder`	`string`	`Search...`
`emptyText`	`string`	`No results found`
`disabled`	`boolean`	—	是否禁用
`maxCount`	`number`	`3`
`maxSelected`	`number`	—
`clearable`	`boolean`	`true`
...rest	`React.HTMLAttributes`	—	透传原生 DOM 属性

📘 完整交互式示例与控件属性请查看 Storybook 文档。