更新记录
1.0.8(2024-07-12) 下载此版本
更新文档
1.0.7(2024-05-17) 下载此版本
修复添加props后层级显示错误的BUG
1.0.6(2024-05-06) 下载此版本
更新示例工程
查看更多平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | - | √ | √ | √ | - | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | √ | - | √ | - | √ | - | - | √ | - | - |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
xm-cascader
组件名:xm-cascader 代码块:
xmCascader
xm-cascader 组件属性说明
重要提醒,该组件依赖uni-popup uni-icons
xm-cascader 组件属性说明
- options: Array,数据源
- value or string: String,绑定的id
- placeholder: String,输入框占位文本
- border: Boolean,是否有边框,默认为 false
- readonly: Boolean,是否仅读,默认为 false
- checkStrictly: Boolean,是否可选择任意一级,默认为 false
- clearable: Boolean,是否显示清空按钮,默认为 false
- showAllLevels: Boolean,是否显示完整路径,默认为 false
- props: Object,{value: 'id', label: 'name', children: 'children'},自定义字段规则
xm-cascader 组件事件说明
- @input: function,选中事件
基本用法
<xm-cascader v-model="value" :options="list"></xm-cascader>
[{
"id": 1,
"name": "Parent 1",
"parentId": 0,
"children": [{
"id": 2,
"name": "Child 1.1",
"parentId": 1,
"children": []
},
{
"id": 3,
"name": "Child 1.2",
"parentId": 1,
"children": []
}
]
},
{
"id": 4,
"name": "Parent 2",
"parentId": 0,
"children": [{
"id": 5,
"name": "Child 2.1",
"parentId": 4,
"children": []
},
{
"id": 6,
"name": "Child 2.2",
"parentId": 4,
"children": [{
"id": 7,
"name": "Grandchild 2.2.1",
"parentId": 6,
"children": []
}]
}
]
}]
无边框 -
<xm-cascader :border="false" v-model="value" :options="list"></xm-cascader>
可清空 -
<xm-cascader :clearable="false" v-model="value" :options="list"></xm-cascader>
可选择任意一级 -
<xm-cascader :clearable="true" v-model="value" :options="list"></xm-cascader>
显示完整路径 -
<xm-cascader :showAllLevels="true" v-model="value" :options="list"></xm-cascader>
绑定事件 -
<xm-cascader @input="change" v-model="value" :options="list"></xm-cascader>
change(e){
console.log('返回的ID:' + e)
}