更新记录
v1.0.1(2025-08-29)
更新日志
1.0.0 (2025-08-29)
平台兼容性
uni-app(4.71)
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
- |
- |
- |
- |
- |
- |
- |
- |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
uni-app x(4.75)
Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
- |
- |
- |
- |
- |
- |
<!--
* @Description:
* @Author: clc
* @Date: 2025-08-29 15:13:48
* @LastEditor: clc
* @LastEditTime: 2025-08-29 15:20:48
-->
clc-cascader 级联选择器
一个基于 uni-app 的多层级选择器,支持禁用状态、路径展示,支持 v-model 双向绑定。
使用方式
<template>
<view>
<clc-cascader
v-model="selectedValues"
:localdata="options"
@change="onChange"
/>
</view>
</template>
<script setup>
import { ref } from 'vue'
const selectedValues = ref([])
const options = [
{
text: '北京',
value: 'beijing',
children: [
{ text: '朝阳区', value: 'chaoyang' },
{ text: '海淀区', value: 'haidian' }
]
},
{
text: '上海',
value: 'shanghai',
children: [
{ text: '浦东新区', value: 'pudong' }
]
}
]
const onChange = (e) => {
console.log('选中结果', e)
}
</script>
Props
属性 |
类型 |
默认值 |
说明 |
localdata |
Array |
[] |
层级数据 |
modelValue |
Array \| String \| Number |
[] |
绑定值(支持数组/单值) |
map |
{ text: string, value: string } |
{ text: 'text', value: 'value' } |
字段映射 |
Events
事件名 |
回调参数 |
说明 |
change |
{ path: SelectedNode[], node: TreeNode } |
选中叶子节点时触发 |
update:modelValue |
any |
v-model 双向绑定 |
nodeclick |
TreeNode |
任意节点点击都会触发 |