# bz-cascader 级联选择器
# 基本用法
级联选择框，用于多层级数据的选择，常用于省市区地址的选择， 1.0.1 版本开始支持此组件。
支持宽屏差异
扫码预览
用BoosHi扫码或PC端点击
<template>
<view class="demo-ui-page">
<view class="demo-content">
<view class="demo-title">bz-cascader 级联选择</view>
<demo-cell>
<bz-cascader
:itemList="itemList"
@complete="complete"
@change="change"
></bz-cascader>
</demo-cell>
<demo-cell :title="'调试'">
<view class="demo-flex-between">
<view></view>
<bz-cascader
style="width: 240px"
v-bind="params"
:itemList="itemList"
@complete="complete"
@change="change"
></bz-cascader>
</view>
</demo-cell>
</view>
</view>
</template>
<script>
import cityData from "./city";
export default {
data() {
return {
itemList: cityData,
params: {
color: "#5358de",
nowrap: true,
placeholder: "请选择城市",
disabled: false,
bordered: true,
isRight: false,
closeable: true,
chooseData: ["340000", "340100", "340102"],
},
};
},
methods: {
changeMyParams(data) {
this.params = data;
},
complete(e) {
console.log("complete:", e);
},
change(e) {
console.log("change:", e);
},
},
};
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
展开 刷新 关闭
# 属性说明
| 属性名 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| color | String | 主题颜色 | #1890ff |
| itemList | CasOption[] | 如果下一级是请求返回，则为第一级数据，否则所有数据 | - |
| chooseData | String[] | 初始化默认选中数据，如[value1, value2, value3] | - |
| placeholder | String | 内容框的默认提示文本 | 请选择 |
| defaultText | String | 滑出场景，header 选择头部的提示文本 | 请选择 |
| textSize | String | 列表内容的字体大小 | 14px |
| subTextSize | String | 列表内容的二级字体大小 | 12px |
| headerLine | Boolean | 是否显示 header 底部细线 | true |
| nowrap | Boolean | 列表内容过长时是否不换行 | true |
| disabled | Boolean | 是否禁用 | false |
| bordered | Boolean | 是否需要边框 | true |
| isRight | Boolean | 结果是否右对齐 | false |
| closeable | Boolean | 是否展示清除按钮 | true |
| request | Boolean | 子集数据是否请求返回（默认 false，一次性返回所有数据） | false |
| receiveData | CasOption[] | 子级数据（当有改变时，默认当前选中项新增子级数据，request=true 时生效） | - |
| @change | { layer: 层级, subIndex: 索引 , chooseOption: 当前选中 } | 选中每层/级时触发事件 | - |
| @complete | { result: 选中数组, value: value 拼接, text: text 拼接 } | 选择完成时触发事件 | - |
| @visibleChange | visible: boolean | 显示隐藏事件 | - |
- CasOption 类型
| 属性名 | 类型 | 说明 |
|---|---|---|
| text | string | 一级标题 |
| subText | string | 二级标题（可选） |
| value | string ｜ number | 内容 value |
| children | CasOption[] | 子级 |