cascade 级联
解释:多级选择组件,为开发者提供级联选择功能,默认为三级。比如:省/市/区。该组件包括左侧标签栏,以及右侧多个 picker(从底部弹起的滚动选择器)。支持配置左侧标签宽度,并提供自定义样式,可供开发者进行定制。
属性说明
属性名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
range | Array | 是 | 多级 picker 的内容数组,需要传入二维数组,格式为[[],[],[]] | |
range-key | String | 是 | 当 range 中的一维数组为[{ range-key : value }]时, range-key 对应的 value 为选择器显示的内容 | |
label-width | String | 否 | 4em | 左侧文字宽度,须包含单位,例如 em 、 px 、 rpx 、 vw 、 vh … 默认为 4 字宽度 4em ( 72px ),6 字宽度为 6em ,建议用 em,可以适配 |
label | String | 否 | 左侧文字描述 | |
placeholder | Array | 否 | [] | picker 没值时默认显示 |
value | Array | 否 | [] | picker 选中时的数组下标 |
change-label-color | Boolean | 否 | false | 是否需要更改组件左侧标签的颜色 |
label-color | String | 否 | #c40311 | change-lable-color 为 true 时的颜色值 |
disabled | Boolean | 否 | false | 未选择第一/二级 picker ,而直接选择其余 picker 时,是否展示禁用 |
tips | Array | 否 | [] | 未按顺序选择第一、二、三级 picker 时,分别弹出tips[0]、tips[1]的提示 |
noborder | Boolean | 否 | false | 整个组件外侧是否有下边框线 |
change | EventHandle | 否 | 每一级 picker 选择时,触发 change 事件 | |
cascade-picker | String | 否 | 级联组件的外部样式类,可用于修改组件最外层样式 | |
cascade-label | String | 否 | 级联组件的外部样式类,可用于修改组件左侧标签样式 | |
cascade-content | String | 否 | 级联组件的外部样式类,可用于修改组件右侧单行 picker 的样式 | |
cascade-picker-content | String | 否 | 级联组件的外部样式类,可用于修改 picker 内容展示样式 |
示例
跳转编辑工具
扫码体验
代码示例
请使用百度APP扫码
代码示例
- SWAN
- JS
- CSS
- JSON
<!--四字标题-->
<smt-cascade
range="{{multiArray1}}"
label="四字标题"
range-key="name"
bind:change="change"
placeholder="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>
<!--配置无下边框-->
<smt-cascade
range="{{multiArray2}}"
label="无下边框""
range-key="name"
noborder="true"
bind:change="change"
></smt-cascade>
<!--配置label-width-->
<smt-cascade
range="{{multiArray3}}"
label="六字标题排版"
range-key="name"
label-width="6em"
bind:change="change"
placeholder="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>
<!--配置tips-->
<smt-cascade
range="{{multiArray4}}"
label="配置未点击时提示"
range-key="name"
bind:change="change"
tips="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>
<!--配置回填数据-->
<smt-cascade
range="{{multiArray5}}"
label="回填"
value="{{[1, 2, 1]}}"
range-key="name"
bind:change="change"
placeholder="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>
<!--配置禁用-->
<smt-cascade
range="{{multiArray6}}"
label="禁用型"
range-key="name"
disabled
bind:change="change"
placeholder="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>
<!--外部样式类-->
<smt-cascade
range="{{multiArray7}}"
label="externalClasses"
cascade-picker="cascade-picker"
cascade-label="cascade-label"
cascade-content="cascade-content"
cascade-picker-content="cascade-picker-content"
range-key="name"
bind:change="change"
placeholder="{{['请选择省', '请选择市', '请选择区']}}"
></smt-cascade>