目录
Props
事件方法
inputChange事件回调参数说明:
completeChange事件回调参数说明:
temList 属性Object参数说明
defaultItemList 属性Object参数说明
在template中使用
由于uniapp uni-ui的data-picke 不支持异步作者自己写了一个 插件市场下载使用
插件市场地址级联数据选择 data-picker 自定义多级选择 多级联动选择、 - DCloud 插件市场
Props
属性名 | 类型 | 说明 | 默认值 |
---|---|---|---|
readonly | Boolean | 只读 |false | |
border | Boolean | 边框 | true | |
clearIcon | Boolean | 清除按钮 | true | |
placeholder | String | 默认提示 |请选择 | |
popupTitle | String | 弹窗标题 |请选择 | |
itemList | Array | 级联数据, 如果下一级是请求返回,则为第一级数据,否则为所有数据 | [ ] |
defaultItemList | Array | 初始化默认选中数据,当一次性传入所有数据时,默认值可为字符串数组,如:['安徽省','阜阳市','颍上县'] | [ ] |
defaultKey | V1.7.2+ String | 默认值字段key,可传值:text,value,仅当一次性传入所有数据时有效 | text |
headerLine | Boolean | 是否显示header底部细线 | true |
headerBgColor | String | header背景颜色 | #FFFFFF |
tabsHeight | String | 顶部标签栏高度 | 88rpx |
text | String | 默认显示文字 | 请选择 |
size | Number | tabs 文字大小 | 28 |
color | String | tabs 文字颜色 | #555 |
activeColor | String | 选中颜色 | #5677fc |
bold | Boolean | 选中后文字加粗 | true |
showLine | Boolean | 选中后是否显示底部线条 | true |
lineColor | String | 线条颜色 | #5677fc |
checkMarkSize | Number | icon 大小 | 15 |
checkMarkColor | String | icon 颜色 | #5677fc |
imgWidth | String | item 图片宽度 | 40rpx |
imgHeight | String | item 图片高度 | 40rpx |
radius | String | 图片圆角 | 50% |
textColor | String | item text颜色 | #333 |
textActiveColor | String | item text选中后颜色 | #333 |
textBold | Boolean | 选中后字体是否加粗 | true |
textSize | Number | item text字体大小 | 28 |
nowrap | Boolean | text 是否不换行 | false |
subTextColor | String | item subText颜色 | #999 |
subTextSize | Number | item subText字体大小 | 24 |
padding | String | item padding | 20rpx 30rpx |
firstItemTop | String | 占位高度,第一条数据距离顶部距离 | 20rpx |
height | String | swiper 高度 | 300px |
backgroundColor | String | item swiper 内容部分背景颜色 | #FFFFFF |
request | Boolean | 子级数据是否请求返回(默认false,一次性返回所有数据) | false |
receiveData | Array | 子级数据(当有改变时,默认为当前选中项新增子级数据,request为true时生效) | [ ] |
reset | [Number, String] | 改变reset值则重置所有数据 |
事件方法
属性 | 类型 | 说明 | 返回值 |
---|---|---|---|
popupopened | Events | 弹框打开时触发 | |
popupclosed | Events | 弹框关闭时触发 | |
completeChange | Events | 选择器中item项点击时触发 | |
inputChange | Events | 选择结果数据 |
inputChange事件回调参数说明:
- layer 当前所属层级
- subIndex 当前层级点击项索引值
- subItem项 当前层级点击项所有数据,由父组件传入的数据
completeChange事件回调参数说明:
- result 当前选择的结果
- text 所有层级选择的text值拼接数据,如:安徽省合肥市庐阳区
- value 最后一级点击项的value值
- subText 最后一级点击项的text值
- src 最后一级点击项的src值
temList 属性Object参数说明
属性 receiveData 数据格式与 itemList中子集数据一致,数据为约定格式,尽量保持一致。
[{src: "", //图标地址text: "",//主文本subText: "",//副文本value: 0, //value值 children:[{text: "",//主文本subText: "",//副文本value: 0,//value值children:[] //子级数据 如果数据长度为0则表示没有下一级数据了}] //子级数据
}]
defaultItemList 属性Object参数说明
数据为约定格式,尽量保持一致,当一次性传入所有数据时,默认值可为字符串数组。
[{text: "", //选中的textsubText: '', //选中的subTextvalue: '', //选中的valuesrc: '', //选中的src,没有则传空或不传index: 0, //选中数据在当前layer索引list: [{src: "",//图标地址text: "", //主文本subText: "",//副文本value: 101 //value值 }] //当前layer下所有数据集合
}]
在template中使用
<template><view><jia-cascader request :itemList="itemList" :receiveData="receiveData" :defaultItemList="defaultItemList" @completeChange="complete" @inputChange="change"></jia-cascader></view>
</template><script>
// data 数据 及 方法
export default {data() {return {itemList: [],receiveData: [],defaultItemList: [{src: '',text: '高一(3)班',subText: '30人',value: 102,index: 1, //选中数据在当前layer索引list: [{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(3)班',subText: '30人',value: 103},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101},{src: '',text: '高一(2)班',subText: '30人',value: 102},{src: '',text: '高一(1)班',subText: '30人',value: 101}] //当前layer下所有数据集合},{text: '周小小', //选中的textsubText: '女', //选中的subTextvalue: 11103, //选中的valuesrc: '', //选中的src,没有则传空或不传index: 2, //选中数据在当前layer索引list: [{text: '张三',subText: '男',value: 11101},{text: '王五',subText: '男',value: 11102},{text: '周小小',subText: '女',value: 11103},{text: '周小小',subText: '女',value: 11103},{text: '周小小',subText: '女',value: 11103}] //当前layer下所有数据集合}]};},onLoad() {this.itemList = [{src: ' ',text: '高一(1)班',subText: '30人',value: 101},{src: ' ',text: '高一(2)班',subText: '30人',value: 102},{src: ' ',text: '高一(3)班',subText: '30人',value: 103},{src: ' ',text: '高一(4)班',subText: '28人',value: 104},{src: ' ',text: '高一(5)班',subText: '28人',value: 105},{src: ' ',text: '高一(6)班',subText: '28人',value: 106},{src: ' ',text: '高一(7)班',subText: '28人',value: 107},{src: ' ',text: '高一(8)班',subText: '38人',value: 108},{src: ' ',text: '高一(9)班',subText: '38人',value: 109},{src: ' ',text: '高一(10)班',subText: '38人',value: 110},{src: ' ',text: '高一(11)班',subText: '38人',value: 111},{src: ' ',text: '高一(12)班',subText: '38人',value: 112}];},methods: {change(e) {console.log(e);/*** layer: 0 第几级 indexsrc: '/static/images/basic/color.png'subIndex: 2 //当前层级下选中项indexsubText: '30人' //选中项数据text: '高一(3)班'value: 103 //选中项value数据* */// 模拟请求let value = e.value;let layer = e.layer;if (layer === 7) {//实际中以请求数据为准,无下级数据则传空数组this.receiveData = [];} else {uni.showLoading({title: '请稍候...'});setTimeout(() => {uni.hideLoading();//请求完成后将数据处理成以下格式,传入,最后一级没有则传空数组switch (layer) {case 0:this.receiveData = [{text: '张三',subText: '男',value: 11101},{text: '王五',subText: '男',value: 11102},{text: '周小小',subText: '女',value: 11103},{text: '周小小',subText: '女',value: 11103},{text: '周小小',subText: '女',value: 11103}];break;case 1:this.receiveData = [{text: '他(她)说',value: 11101}];break;case 2:this.receiveData = [{text: '这是一个',value: 11101}];break;case 3:this.receiveData = [{text: '级联选择器',value: 11101}];break;case 4:this.receiveData = [{text: '测试例子',value: 11101}];break;case 5:this.receiveData = [{text: '总共',value: 11101}];break;case 6:this.receiveData = [{text: '8级数据',value: 11101}];break;default:break;}}, 800);}},complete(e) {console.log(e);console.log('您选择的数据为:' + e.text);}}
};
</script>