Cascader 多级地址级联选择 APP
该方法或组件支持移动端小程序调用
PC
该方法或组件支持桌面端小程序调用

引入方式

数字生活小程序工程中,不需要 import,直接使用组件标签即可。

import { Cascader } from '@21cnfe/vui'  
Vue.component('Cascader', Cascader)

代码演示

基本用法 接收一个树状对象数组,可用于多级地址选项选择
<h3>使用方法</h3>
<Cascader ref="cascader" :options="options" v-model="selectedList" @onSelect="handleSelect" />
<h3>配合Actionsheet弹出层一起使用</h3>
<ok-button type="primary" @onClick="handleCustom">级联地址选择</ok-button>
<ActionSheet type="custom" :visible.sync="customShow" id="customActionSheet">
<div slot="customContent" class="actionsheet-content">
<p class="title">级联地址选择器组件示例</p>
<Cascader :options="options" v-model="selectedList" @onSelect="handleSelect" />
</div>
</ActionSheet>
const options = [
{
text: '广东省',
value: '1000',
children: [
{ text: '广州市', value: '1100', children: [
{ text: '天河区', value: '1110', children: [
{ text: '石牌街道', value: '1111', children: [
{ text: '天鹅花园小区', value: '11111' },
{ text: '云顶天宫小区', value: '11112' },
]},
{ text: '上舍街道', value: '1112' },
{ text: '车陂街道', value: '1113' },
{ text: '天河公园街道', value: '1114' },
{ text: '体育中心街道', value: '1115' },
]},
{ text: '番禺区', value: '1120' },
{ text: '越秀区', value: '1130' },
{ text: '海珠区', value: '1140' },
{ text: '白云区', value: '1150' },
]},
{ text: '中山市', value: '1200' },
{ text: '佛山市', value: '1300' },
{ text: '珠海市', value: '1400' },
{ text: '深圳市', value: '1500' }
],
}
];
export default {
data () {
return {
options,
customShow: false,
selectedList: [],
activeIndex: 0
}
},
watch: {
selectedList (val) {
console.log(val)
}
},
methods: {
handleCustom () {
this.customShow = true
},
handleSelect (option) {
// 异步添加子级示例
if (option.text === '深圳市'){
setTimeout(() => {
let children = [
{ text: '宝山区', value: '1510' },
{ text: '福田区', value: '1520' }
];
this.options[0].children[4].children = children;
option.children = children;
this.$refs.cascader.update(option);
}, 500);
}
}
}
}

API

属性 说明 类型 默认值
options 地址树状数组,选项属性包括 text 显示文本(必需),value 值(必需)、children 子元素(非必需) Array []

Events

事件名称 说明 回调参数
onSelect 地址选项选中回调 当前选中值

v-model

绑定所有选中选项数组,可用 watch 监听数组变化。

  1. 1. Cascader 多级地址级联选择 APP 该方法或组件支持移动端小程序调用 PC 该方法或组件支持桌面端小程序调用
    1. 1.1. 引入方式
    2. 1.2. 代码演示
    3. 1.3. API
    4. 1.4. Events
    5. 1.5. v-model