更新记录
1.0.0.6(2026-01-06) 下载此版本
master
1.0.0.5(2026-01-06) 下载此版本
master
1.0.0.4(2026-01-06) 下载此版本
master
查看更多平台兼容性
uni-app(4.13)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | - | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|
| √ | - | - | - | - | - | - | - | - | - | - |
其他
| 多语言 | 暗黑模式 | 宽屏模式 |
|---|---|---|
| × | × | √ |
安装
在市场导入xf-multiple-cascader uni_modules版本的即可,无需import
组件关联说明
代码演示
基本用法
- 使用组件代码如下:
不在表单使用时,自定义插槽
<template>
<scroll-view class="xf-col-center" scroll-y>
<view style="width: 100%;">
<xf-multiple-cascader required pickerTitle="级联选择" v-model:show="show" v-model:modelValue="model1" :isRelationship="false"
:apiFn="getTreeData">
<xf-fm-select title="标题" @click="show = true" v-model:value="formValueText"> </xf-fm-select>
</xf-multiple-cascader>
</view>
</scroll-view>
</template>
基础用法,主要用于表单
<template>
<scroll-view class="xf-col-center" scroll-y>
<h3>级联组件-父子不联动</h3>
<view style="width: 100%;">
<xf-multiple-cascader required pickerTitle="级联选择" v-model:modelValue="model1" :pickerTip="prompt" :isRelationship="false"
:apiFn="getTreeData"></xf-multiple-cascader>
</view>
<h3>级联组件-父子联动</h3>
<view style="width: 100%;">
<xf-multiple-cascader required isRelationship :isLeaf="true" pickerTitle="级联选择" v-model:modelValue="model2" :pickerTip="prompt" :isRelationship="false"
:apiFn="getTreeData"></xf-multiple-cascader>
</view>
<view style="width: 100%;">
<xf-multiple-cascader required isRelationship pickerTitle="级联选择" v-model:modelValue="model3" :pickerTip="prompt" :isRelationship="false"
:apiFn="getTreeData"></xf-multiple-cascader>
</view>
</scroll-view>
</template>
<script setup lang="ts">
import { onMounted, ref, watch } from 'vue';
const show = ref(false)
const prompt = ref("提示内容")
const model1 = ref([{
children : [],
fullName:"fffff",
value:4
}])
const model2 = ref()
const model3 = ref()
/**
* 模拟创建一个接口数据
*/
const getTreeData = () => {
return new Promise((resolve) => {
setTimeout(() => {
let list = {
list: singleLists.value
}
resolve(list)
}, 600)
})
}
const singleLists = ref([
{
label: 'xxxx',
value: 1,
children: [
{
label: '好多好多字好多好多字', value: 1000,
children: [
{ label: '好多好多字好多好多字', value: 10001, },
{ label: '我的生活', value: 10002, },
{ label: 'xxxx', value: 10003, }
]
},
{ label: '我的生活', value: 1001, },
{ label: 'xxxx', value: 1002, }
]
},
{
label: '好多好多字好多好多字好多好多字好多好多字好多好多字',
value: 2
},
{
label: 'sssss',
value: 3
},
{
label: 'fffff',
value: 4
},
{
label: 'sdfadfsdf',
value: 5
},
{
label: 'fsdfsdf',
value: 6
},
{
label: 'sfadfsf',
value: 7
},
]);
</script>
API
Props
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| v-model:modelValue | 当前选择内容 | array | - |
| v-model:show | 自定义插槽时,是否打开弹窗 | boolean | false |
| pickerTitle | 表单标题 | string | - |
| pickerBottomTip | 表单标题下面提示语 | object|string |
- |
| pickerTip | 表单提示语 | string | - |
| required | 是否必填 | boolean | false |
| tip | 弹框副标题 | string | - |
| title | 弹框标题 | string | - |
| apiFn | 获取列表数据事件 | func | - |
| childrenKey | 子级列表key | string | children |
| valueKey | 列表对象value值对应的key | string | value |
| labelKey | 列表对象label值对应的key | string | label |
| isRelationship | 是否关联 | boolean | true |
| isReturnValue | v-model 中 是否只返回 valueKey | boolean | fasle |
| isFullName | 完整名称的key值 | boolean | true |
| isLeaf | 只显示叶子节点 | boolean | fasle |
事件 Emits
| 事件名 | 说明 | 返回值 |
|---|---|---|
| confirm | 点击确认事件 | |
| close | 关闭事件 |
插槽 slot
| 名称 | 说明 | 返回值 |
|---|---|---|
| content | 当不是表单组件时,用于自定义 |

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 286
赞赏 0
下载 13007014
赞赏 1839
赞赏
京公网安备:11010802035340号