AutoComplete 自动补全
WebH5
自动补全输入框。输入时按包含过滤建议列表,键盘上下选择、Enter 填入。
何时使用
输入内容可从已知集合中联想补全:搜索词、城市、标签。
何时不使用
只能从固定选项中选择且不允许自由输入时用 Select。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 绑定值(v-model) |
suggestions | (string | { label: string; value: string })[] | "[]" | 建议列表:字符串数组或 { label, value } 数组 |
placeholder | string | "\"\"" | 占位文本 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空,有值时显示清空按钮 |
filterable | boolean | true | 输入时按包含过滤;false 全量展示 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入或选中建议时触发 |
select | string | 选中建议项时触发,参数为选中项 value |
change | string | 选中建议或清空时触发 |
clear | void | 点击清空按钮时触发 |
示例
基础
示例加载中…
对象建议与可清空
示例加载中…
全量展示
示例加载中…
Playground
加载中…
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 AutoComplete 文档(含手机预览)。