AutoComplete 自动完成
uni-appH5微信小程序App
跨端输入建议组件,支持本地过滤和选中事件。
何时使用
输入内容可从已知集合中联想补全:搜索词、城市、标签。
何时不使用
只能从固定选项中选择且不允许自由输入时用 Select。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 绑定值(v-model) |
suggestions | Array<string | AutoCompleteOption> | [] | 建议列表:字符串数组或 { label, value } 数组 |
placeholder | string | "请输入" | 占位文本 |
disabled | boolean | false | 禁用 |
filterable | boolean | true | 输入时按包含过滤;false 全量展示 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
clearable | boolean | false | 可清空,有值时显示清空按钮 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入或选中建议时触发 |
select | string | 选中建议项时触发,参数为选中项 value |
change | string | 选中建议或清空时触发 |
clear | void | 点击清空按钮时触发 |
示例
基础用法
vue
<AutoComplete v-model="value1" :suggestions="suggestions" placeholder="输入 ru 试试" />关闭过滤
vue
<AutoComplete v-model="value2" :suggestions="suggestions" :filterable="false" placeholder="展示全部候选" />禁用
vue
<AutoComplete v-model="value3" :suggestions="suggestions" disabled placeholder="不可输入" />尺寸与清空
vue
<AutoComplete v-model="kw" :suggestions="suggestions" placeholder="大号 · 可清空" size="lg" clearable />