Skip to content

AutoComplete 自动补全输入框

规则

基础示例

Props 配置示例

整段禁用

尺寸对比(迷你 / 小 / 中)

Props

名称类型默认值说明
clearablebooleanfalse是否可清空
debouncenumber300获取输入建议的去抖延时
disabledboolean是否禁用
display-onlybooleanfalse设置只读
fetch-suggestionsIAutocompleteFetchSuggestions返回输入建议的方法,仅当你的输入建议数据 resolve 时,通过调用 callback 来返回它
hide-loadingbooleanfalse是否隐藏远程加载时的加载图标
highlight-first-itembooleanfalse是否默认突出显示远程搜索建议中的第一项
labelstring等价于原生 input aria-label 属性
namestringinput 元素的原生属性
placeholderstring输入框占位文本
placementIAutocompletePlacement'bottom-start'菜单弹出位置
popper-append-to-bodybooleantrue是否将下拉列表插入至 body 元素。在下拉列表的定位出现问题时,可将该属性设置为 false
popper-classstring下拉列表的类名
prefix-iconComponent输入框头部图标
select-when-unmatchedbooleanfalse在输入没有任何匹配建议的情况下,按下回车是否触发 select 事件
size'medium' | 'small' | 'mini'设置组件大小
suffix-iconComponent输入框尾部图标
trigger-on-focusbooleantrue是否在输入框 focus 时显示建议列表
v-modelstring必填值,输入绑定值
value-keystring'value'在输入建议对象中,用于显示和匹配输入的键名

Events

名称类型说明
select(selection: IAutocompleteSuggestionItem) => void点击选中建议项时触发,回调参数为 fetch-suggestions 中传入的项

事件示例

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用