更新记录
1.0(2025-08-08)
下载此版本
上传1.0版本
平台兼容性
uni-app(4.07)
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
- |
- |
- |
- |
- |
- |
- |
- |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
使用说明
插件功能介绍
级联选择,可任意级别选择,不必非要选择到最后一级。
提供了禁用功能,可以控制每一项是否可选。
数据源
可以是本地数据,也支持懒加载,可以自行定义加载方法。
本地数据和懒加载任选一个,不能同时使用。
使用本地数据时,必须时树形结构,字段可以通过props自行配置。
API
属性
属性名 |
类型 |
可选值 |
默认值 |
说明 |
title |
String |
- |
请选择 |
标题,也可以使用slot插槽 |
data |
Array |
- |
- |
本地数据 |
loadData |
Function |
- |
null |
懒加载函数 |
props |
Object |
- |
- |
详细配置可以参考下面配置内容 |
tabDefaultLabel |
String |
- |
请选择 |
tab最后一项,没有选择时的默认提示文本 |
props属性
属性名 |
类型 |
可选值 |
默认值 |
说明 |
label |
String |
- |
label |
可选项的展示文本 |
value |
String |
- |
value |
可选项目的唯一标识 |
children |
String |
- |
children |
子项目数组 |
disabled |
Boolean、Function |
- |
- |
子项目禁用属性,也可以是一个函数,当该属性为函数时,会将子项目作为参数传给它 |
事件(Events)
事件名称 |
说明 |
参数 |
返回值 |
@confirm |
点击确定按钮时调用 |
选择的数组 |
- |
方法(Methods)
方法名称 |
说明 |
参数 |
返回值 |
show |
打开 |
- |
- |
close |
关闭 |
- |
- |
插槽(Slots)
名称 |
说明 |
参数 |
title |
标题 |
- |
item |
每一项 |
当前项数据 v-lost:item="{data}" |
使用样例
<view @click="show">
打开
</view>
<nianDataPickerVue ref="nianDataPickerVue" title="请选择区域" tabDefaultLabel="搞快点" @confirm="confirm" :loadData="loadData" :props="props">
<template v-slot:title>
请选择内容
</template>
<template v-slot:item="{ data }">
{{ data.text }}
</template>
</nianDataPickerVue>
/**
* 点击选中某一项过后,调用加载子集的回调,初始化时会自己调用该函数,data为null
* @param {Object} data 点击选中的项目
* @param {Object} list 选中的所有项目数组
*/
loadData(data, list) {
return new Promise(res => {
if (data) {
res([
{
id: data.id + 1,
text: data.id + 1 + '附加费凉快的',
disabled: data.id + 1 > 2
}
]);
} else {
res([{
id: 1,
text: '都看见'
}])
}
})
},
/**
* 打开
*/
show() {
this.$refs.nianDataPickerVue.show();
},
/**
* 点击确定的回调
* @param {Object} list 选择的数据
*/
confirm(list) {
console.log(list);
},