更新记录
1.0.0(2026-01-20)
下载此版本
支持多选功能
支持选项禁用
支持自定义显示值
支持搜索
支持多选时将选中值按文字形式展示
监听搜索输入事件
平台兼容性
uni-app(3.6.18)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
√ |
- |
- |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
√ |
√ |
- |
√ |
- |
√ |
- |
√ |
√ |
其他
mxl-selectDown 下拉选择器组件
支持多选功能
支持选项禁用
支持自定义显示值
支持搜索
支持多选时将选中值按文字形式展示
监听搜索输入事件
先使用前需要安装uni-icons
地址:(https://uniapp.dcloud.net.cn/component/uniui/uni-icons.html)
| 属性名 |
类型 |
默认值 |
说明 |
| v-model |
String、Array、Number |
- |
选中项绑定值 |
| multiple |
Boolean |
false |
是否多选 |
| disabled |
Boolean |
false |
是否禁用 |
| dataKey |
String |
"key" |
作为 key 唯一标识的键名 |
| dataValue |
String |
"value" |
作为 value 唯一标识的键名 |
| filterable |
Boolean |
false |
是否开启搜索 |
| collapseTags |
Boolean |
false |
多选时是否将选中值按文字的形式展示 |
| collapseTagsNum |
Number |
1 |
多选时选中值按文字的形式展示的数量 |
| localdata |
Array |
- |
下拉列表本地数据 |
| label |
String |
- |
左侧标题 |
| placeholder |
String |
"请选择" |
输入框的提示文字 |
| emptyTips |
String |
"无选项" |
无选项提示 |
| clear |
Boolean |
true |
是否清空 |
| outFilterable |
Boolean |
false |
是否开启远程搜索 |
| format |
String |
- |
格式化输出 用法 field="_id as value, version as text, uni_platform as label" format="{label} - {text}" |
| @inputChange |
event |
event(String) |
搜索输入事件 |
| @change |
event |
event(String) |
选中发生变化触发事件 |
<template>
<mxl-selectDown
:localdata="userList"
v-model='userId'
dataValue="userId"
dataKey="userName"
placeholder="请选择城市"
@change="onChange"
@inputChange='handleRemoteSearch'
/>
</template>
data() {
return {
userId:null,
userList:[{
userName:'北京',
userId:1
},{
userName:'上海2',
userId:2
},{
userName:'天津',
userId:3
}],
}
},
methods: {
// 搜索事件
handleRemoteSearch(){
// 后台接口
},
// 单选变化事件
onChange(e) {
console.log('单选选择变化:', e);
},
}