更新记录
1.0.1(2025-06-07)
下载此版本
1.0.1(2025-06-07)
样式布局修改接近官方样式
1.0.0(2025-06-07)
下载此版本
无
平台兼容性
云端兼容性
uni-app(4.55)
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
uni-app x(4.55)
Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
√ |
√ |
√ |
√ |
√ |
√ |
其他
ay-data-mult-select 数据多选下拉框
数据多选下拉框组件,支持本地数据和云端数据,支持最大最小选择数量限制。
平台兼容性
App-vue |
App-nvue |
H5 |
微信小程序 |
支付宝小程序 |
百度小程序 |
抖音小程序 |
QQ小程序 |
快应用 |
360小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
基本用法
<template>
<view>
<ay-data-mult-select v-model="value" :localdata="localdata" @change="change"></ay-data-mult-select>
</view>
</template>
<script>
export default {
data() {
return {
value: [],
localdata: [{
text: '选项1',
value: '1'
}, {
text: '选项2',
value: '2'
}, {
text: '选项3',
value: '3'
}]
}
},
methods: {
change(e) {
console.log('选中的值:', e)
}
}
}
</script>
云端数据用法
<template>
<view>
<ay-data-mult-select v-model="value" collection="opendb-app-list" field="name as text, appid as value" @change="change"></ay-data-mult-select>
</view>
</template>
<script>
export default {
data() {
return {
value: []
}
},
methods: {
change(e) {
console.log('选中的值:', e)
}
}
}
</script>
API
Props
属性名 |
类型 |
默认值 |
说明 |
value/v-model |
Array |
[] |
默认值 |
localdata |
Array |
[] |
本地数据,格式为 [{text:'',value:''}] |
collection |
String |
- |
云端数据表名 |
field |
String |
- |
云端数据表字段,多个字段用 , 分割 |
where |
String |
- |
云端数据查询条件 |
orderby |
String |
- |
云端数据排序字段及正序倒叙设置 |
clear |
Boolean |
true |
是否可以清空已选项 |
emptyTips |
String |
'无选项' |
没有数据时显示的文字 |
label |
String |
'' |
左侧标题 |
placeholder |
String |
'请选择' |
输入框的提示文字 |
disabled |
Boolean |
false |
是否禁用 |
placement |
String |
'bottom' |
弹出位置,可选值:top/bottom |
min |
Number/String |
0 |
最小选择个数 |
max |
Number/String |
0 |
最大选择个数 |
format |
String |
'' |
格式化输出,用法:field="_id as value, version as text, uni_platform as label" format="{label} - {text}" |
Events
事件名 |
说明 |
返回值 |
change |
选中值变化时触发 |
选中的值数组 |
input |
选中值变化时触发 |
选中的值数组 |
update:modelValue |
选中值变化时触发 |
选中的值数组 |
注意事项
- 组件支持本地数据和云端数据两种模式
- 云端数据模式下,需要指定 collection 和 field 属性
- 可以通过 min 和 max 属性限制选择的数量范围
- 组件支持 v-model 双向绑定
- 组件支持禁用状态
- 组件支持清空已选项
- 组件支持自定义格式化输出
- 组件支持自定义弹出位置
- 组件支持自定义提示文字
- 组件支持自定义无数据提示文字
示例项目
插件示例