更新记录

1.0.1(2026-03-27) 下载此版本

对页面进行nvue的兼容处理

1.0.0(2026-03-27) 下载此版本

1.0.0,初始版本,配置了弹窗选择器,兼容了vue2、vue3和nvue,支持多端平台。


平台兼容性

uni-app(3.7.2)

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

其他

多语言 暗黑模式 宽屏模式

1.0.0(2026-03-27)

nvue-cascader 省市区选择器(兼容vue2、vue3、nvue、安卓、ios、h5、小程序)

使用方法:

<template>
    <view>
        <nvue-cascader 
            ref="cascaderRef" 
            v-model="siteData"
            @confirm="confirm"
        ></nvue-cascader>

        <button @click="open()">选择地区</button>
    </view>
</template>

<script>
    import nvueCascader from '@/uni_modules/nvue-cascader/components/nvue-cascader/nvue-cascader';
    export default {
        data() {
            return {
                siteData: [], // 选择的数据自动返回在这里,也可以选择使用@confirm方法获取到数据进行处理
            }
        },
        methods: {
            open () {
                // 打开地区选择器
                this.$refs.cascaderRef.open();
            },
            confirm (val) {
                // 点击确认按钮之后拿到数据之后返回,也可以选择使用v-model绑定数组获取数据
                console.log(val);
            },
        },
    }
</script>

<style>
</style>
#### 事件说明

|   事件名    | 返回值 |      描述      |
| :---------: | :----: | :------------: |
| @confirm |   对象(code,完整地区名称)   | 点击确定的回调 |
| @cancel | 无 | 点击取消的回调 |
| @open | 无 | 弹窗开启动画结束的回调 |
| @close | 无 | 弹窗关闭动画结束的回调 |

#### Prop

| 参数名称 | 描述                           |
| -------- | ------------------------------ |
| popHeight | 选择器弹窗高度,默认0.8,表示页面高度的80%,最大值为1 |
| backgroundColor | 背景遮罩颜色,默认rgba(0, 0, 0, 0.6) |
| maskClosable | 是否允许点击背景遮罩关闭弹窗,默认允许 |
| allEnd | 是否必须选择到最后层级,才能保存数据,默认为true |
| themeColor | 主题颜色,默认#000 |
| v-model | 数据回填,格式为:[{label: '北京市'}, ...],或者传递code值:[{value: '110000'}, ...],二者至少传递其中一种 |

隐私、权限声明

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

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

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

许可协议

MIT协议