AutoComplete 自动补全输入框
规则
基础示例
Props 配置示例
支持清除 + 受控展开
搜索联动动态更新 options
整段禁用
尺寸对比(小 / 中 / 大)
Events 事件示例
监听选择与输入变化
value: string
Props
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| allowClear | 支持清除 | boolean | | false | - |
| backfill | 使用键盘选择选项的时候把选中项回填到输入框中 | boolean | false | - |
| classes | 用于自定义组件内部各语义化结构的 class,支持对象或函数 | Record<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string> | - | - |
| defaultActiveFirstOption | 是否默认高亮第一个选项 | boolean | true | - |
| disabled | 是否禁用 | boolean | false | - |
| getPopupContainer | 菜单渲染父节点 | (triggerNode: HTMLElement) => HTMLElement | () => document.body | - |
| labelRender | 自定义当前选中的 label 内容 render | (props: LabelInValueType) => VueNode | - | - |
| notFoundContent | 当下拉列表为空时显示的内容 | VueNode | - | - |
| open | 是否展开下拉菜单 | boolean | - | - |
| options | 数据化配置选项内容 | { label: VueNode; value: string }[] | - | - |
| optionRender | 自定义下拉选项渲染 | (option: FlattenOptionData<BaseOptionType>, info: { index: number }) => VueNode | - | - |
| placeholder | 输入框提示 | string | - | - |
| popupMatchSelectWidth | 下拉菜单和选择器同宽 | boolean | number | true | - |
| popupRender | 自定义下拉框内容 | (menu: VueNode) => VueNode | - | - |
| showSearch | 搜索配置 | boolean | SearchConfig | true | - |
| size | 控件大小 | large | middle | small | - | - |
| status | 设置校验状态 | error | warning | - | - |
| styles | 用于自定义组件内部各语义化结构的行内 style,支持对象或函数 | Record<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties> | - | - |
| value | 指定当前选中的条目,支持 v-model:value | string | - | - |
| variant | 形态变体 | outlined | borderless | filled | underlined | outlined | - |
| virtual | 设置 false 时关闭虚拟滚动 | boolean | true | - |
Events
| 事件 | 说明 | 类型 | 版本 |
|---|---|---|---|
| blur | 失去焦点时的回调 | (e: FocusEvent) => void | - |
| change | 选中 option,或 input 的 value 变化时,调用此函数 | (value: string) => void | - |
| clear | 清除内容时的回调 | () => void | - |
| focus | 获得焦点时的回调 | (e: FocusEvent) => void | - |
| inputKeydown | 按键按下时回调 | (e: KeyboardEvent) => void | - |
| openChange | 展开下拉菜单的回调 | (open: boolean) => void | - |
| popupScroll | 下拉列表滚动时的回调 | (e: UIEvent) => void | - |
| search | 搜索补全项的时候调用 | (value: string) => void | - |
| select | 被选中时调用,参数为选中项的 value 值 | (value: string, option: Option) => void | - |


