非 template/render 模式下,请使用 h-autocomplete。
可以使用dict调用系统全局配置的字典,或者通过datas传递数据。
可以通过全局配置autocomplete.default参数设置控件默认的参数值。
autocomplete有三种数据类型:key,title,object,如果需求更复杂,请监听change事件手动处理。
使用mustMatch参数即可。
此种方式只能选择使用title与object类型的数据。
设置endInput可以设定特殊字符确定输入,类似enter键。
通过自定义className参数,自己定义特殊的样式。
通过top以及bottom的slot,自定义其他的内容。
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| disabled | 是否禁用 | Boolean | - | false |
| type | 类型 | String | key, object, title | key |
| option | 配置项,详细参见下面的option说明 | Object | - | |
| multiple | 多选 | Boolean | - | false |
| mustMatch | 是否必须是选择的项 | Boolean | - | true |
| datas | 选择的数据 | Array, Object | - | |
| dict | 调用全局定义的字典 | String | - | - |
| placeholder | 展示默认提示语 | String | - | 请选择 |
| show | 默认展示的文字,针对与存储key值,但是拥有show值的情景 | String | - | - |
| emptyContent | 没有搜索到值的提示语 | String | - | 未搜索到相关数据 |
| config | 使用全局配置的方法 | String | - | - |
| className | 自定义className | String | - | |
| autoSelectFirst | 是否自动选中第一个选项 | Boolean | - | false |
| endInput | 设定特殊字符触发enter | String | - | |
| showDropdownWhenNoResult | 当无数据的时候,是否展示下拉列表 | Boolean | - | true |
| 事件名 | 说明 | 返回数值 |
|---|---|---|
| input | model值产生变化的触发 | model对应的值 |
| change | model值产生变化的触发 | 现在的数据对象,以及触发来源事件:enter, blur, picker, remove, clear |
| 事件名 | 说明 | 参数 |
|---|---|---|
| hide | 隐藏下拉框 | 无 |
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| key | 数据的key对应字段 | String | - | 全局配置autocomplete.default.key |
| title | 数据的title对应字段 | String | - | 全局配置autocomplete.default.title |
| getValue | 通过数据定义出标准的输出格式 | Function | - | - |
| minWord | 开始查询的最低单词数量 | Number | - | 0 |
| loadData | 异步获取数据的方法 | Function | - | - |
| delay | 数据获取的delay时间,提升性能,单位为毫秒 | Number | - | 100 |