更新记录

1.0.0.1(2025-12-30) 下载此版本

master

1.0.0(2025-12-30) 下载此版本

master


平台兼容性

uni-app(4.45)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - -

其他

多语言 暗黑模式 宽屏模式
× ×

安装

在市场导入xf-cascaderuni_modules版本的即可,无需import

组件关联说明

基本用法

  • 使用组件代码如下:
<template>
    <view>
        <xf-cascader title="地址1" v-model:valueList="valueList1" :dataList="sectionList1"
            @change="selectorData"></xf-cascader>

        <xf-cascader title="地址2" customClass="b-mt16" v-model:valueList="valueList2" :dataList="sectionList2"
            @change="selectorData"></xf-cascader>
    </view>

</template>
<script lang="ts" setup>
    import { ref } from 'vue';
    import { CascaderData } from '../../../uni_modules/xf-ts/type/type-common';

    const valueList1 = ref([])
    const valueList2 = ref([2, '210101', '1000'])

    const sectionList1 = ref<Array<CascaderData>>([{
        label: '北京市', value: 1, children: [
            {
                label: '北京市', value: '50'
            }]
    },
    {
        label: '浙江省', value: 2, children: [
            {
                label: '杭州市', value: '210101'
            },
            {
                label: '宁波市', value: '310101',
            },
            {
                label: '温州市', value: '410101'
            },
        ]
    }
    ])

    const sectionList2 = ref<Array<CascaderData>>([{
        label: '北京市', value: 1, children: [
            {
                label: '北京市', value: '50', children: [
                    { label: '东城区', value: '110101' },
                    { label: '西城区', value: '110102' },
                    { label: '朝阳区', value: '110105' }]

            }
        ]
    }, {
        label: '浙江省', value: 2, children: [
            {
                label: '杭州市', value: '210101', children: [
                    { label: '滨江区', value: '1000' },
                    { label: '上城区', value: '1001' },
                    { label: '拱墅区', value: '1002' },
                    { label: '西湖区', value: '1003' },
                    { label: '萧山区', value: '1004' },
                    { label: '余杭区', value: '1005' },
                    { label: '富阳区', value: '1006' },
                    { label: '临安区', value: '1007' },
                    { label: '临平区', value: '1008' },
                    { label: '钱塘区', value: '1009' },
                    { label: '富阳区', value: '1006' },
                    { label: '临安区', value: '1007' },
                    { label: '临平区', value: '1008' },
                    { label: '钱塘区', value: '1009' }
                ]
            },
            {
                label: '宁波市', value: '310101', children: [
                    { label: '海曙区', value: '4000' },
                    { label: '江北区', value: '5000' },
                    { label: '北仑区', value: '6000' }
                ]

            },
            {

                label: '温州市', value: '410101', children: [
                    { label: '鹿城区', value: '7000' },
                    { label: '龙湾区', value: '8000' },
                    { label: '洞头区', value: '9000' }
                ]

            }]
    }])

    const selectorData = (e) => {
        console.log(e)
    }
</script>

API

Props

属性名 说明 类型 默认值
v-model:valueList 绑定当前选中标签列表(每一级数据对象) array false
title 标题 string 请选择所在地区
dataList 级联可选列表对象必须CascaderData array<CascaderData> -
customClass 自定义class string -
required 是否显示必填 boolean -

事件 Emits

事件名 说明 返回值
change 最后一级激活的标签改变时触发

隐私、权限声明

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

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

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

许可协议

MIT协议

暂无用户评论。