Combobox 组合框

业务组件

结合输入框和下拉列表的组合选择控件,支持自定义输入和选项匹配。

何时使用

需要组合框功能时使用本组件。

tsx

import { Combobox } from "@/components/business/combobox"

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

tsx

<Combobox>Normal</Combobox>
<Combobox disabled>Disabled</Combobox>

Prop	Type	Default	说明
`className`	`string`	—	自定义样式类名
`options`	`ComboboxOption[]`	—	可选项列表
`value`	`string`	—	当前值(受控)
`onChange`	`() => void`	—	值变化回调
`placeholder`	`string`	`选择...`	占位文本
`searchPlaceholder`	`string`	`搜索...`
`emptyText`	`string`	`未找到结果`
`disabled`	`boolean`	—	是否禁用
`align`	`"start" \| "center" \| "end"`	`start`	对齐方式
`clearable`	`boolean`	`true`
`searchable`	`boolean`	`true`
`renderOption`	`(...args) => unknown`	—
...rest	`React.HTMLAttributes`	—	透传原生 DOM 属性

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