跳到主要内容

AutoComplete 自动完成 ​

uni-appH5微信小程序App

跨端输入建议组件,支持本地过滤和选中事件。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
AutoComplete 自动完成 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

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

示例 ​

基础用法 ​

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 />