更新记录

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 当不是表单组件时,用于自定义

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。