更新记录

1.0.2（2026-04-16） 下载此版本

1，优化了列表底部被按钮栏遮挡问题 2，直辖市选择优化，现在是：北京市 > 直辖市 > 东城区

1.0.1（2026-03-27） 下载此版本

对页面进行nvue的兼容处理

1.0.0（2026-03-27） 下载此版本

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

平台兼容性

uni-app(3.7.6)

其他

1.0.0（2026-03-27）

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

使用方法：

<template>
    <view>

        <view class="btn_wrap">
            <view class="btn" @click="open()">
                <text v-if="siteData.length<1" class="btn_text">选择地区</text>
                <text class="btn_text" v-for="item,index in siteData" :key="index">{{item.label}}</text>
            </view>
        </view>

        <!-- 地区选择器 -->
        <nvue-cascader 
            ref="cascaderRef" 
            v-model="siteData"
            @confirm="confirm"
        ></nvue-cascader>

    </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 scoped>

.btn_wrap{
    padding: 30rpx;

    display: flex;
    flex-direction: row;
    justify-content: center;
    align-items: center;
}
.btn{
    width: 690rpx;
    height: 100rpx;
    display: flex;
    flex-direction: row;
    justify-content: center;
    align-items: center;
    background-color: #000;
    border-radius: 10rpx;
}

.btn_text{
    font-size: 28rpx;
    color: #FFF;
    margin: 0 10rpx;
    text-align: center;
}

</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'}, ...]，二者至少传递其中一种 |