跳到主要内容

AutoComplete 自动补全 ​

WebH5

自动补全输入框。输入时按包含过滤建议列表,键盘上下选择、Enter 填入。

何时使用 ​

输入内容可从已知集合中联想补全:搜索词、城市、标签。

何时不使用 ​

只能从固定选项中选择且不允许自由输入时用 Select。

Props ​

名称类型默认值说明
modelValuestring"\"\""绑定值(v-model)
suggestions(string | { label: string; value: string })[]"[]"建议列表:字符串数组或 { label, value } 数组
placeholderstring"\"\""占位文本
sizestring:'sm' | 'md' | 'lg'"md"尺寸
disabledbooleanfalse禁用
clearablebooleanfalse可清空,有值时显示清空按钮
filterablebooleantrue输入时按包含过滤;false 全量展示

Events ​

名称载荷说明
update:modelValuestring输入或选中建议时触发
selectstring选中建议项时触发,参数为选中项 value
changestring选中建议或清空时触发
clearvoid点击清空按钮时触发

示例 ​

基础 ​

示例加载中…

对象建议与可清空 ​

示例加载中…

全量展示 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 AutoComplete 文档(含手机预览)。