更新记录

1.0.0(2025-04-17) 下载此版本

省市区、树形数据,三级联动选择器


平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.99 app-vue ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

uniapp 省市区三级联动选择器

组件名:dj-area-picker 代码块: <dj-area-picker>

dj-area-picker组件是省市区三级联动选择器组件,支持树行结构的地区数据渲染,编译兼容H5+小程序端+App端。

引入方式

import djAreaPicker from '../../components/dj-area-picker/dj-area-picker.vue';
export default {
    components: {
        djAreaPicker
    },
    data() {
        return {

        }
    },
    methods: {
    }
}

基本用法

示例

  • view代码
<dj-area-picker :areaData="areaData" :defaultCode="defaultCode" @change="changeArea">
    <view name="slot" class="picker">
        当前选择:{{ data.province.name }} - {{ data.city.name }} - {{ data.area.name }}
    </view>
</dj-area-picker>
  • html代码实现
<template>
    <view>
        <dj-area-picker :areaData="areaData" :defaultCode="defaultCode" @change="changeArea">
            <view name="slot" class="picker">
                当前选择:{{ data.province.name }} - {{ data.city.name }} - {{ data.area.name }}
            </view>
        </dj-area-picker>
    </view>
</template>

<script>
    import djAreaPicker from '../../components/dj-area-picker/dj-area-picker.vue';
    export default {
        components: {
            djAreaPicker
        },
        data() {
            return {
                defaultCode:['310000','310100','310104'],
                areaData:[
                    { 
                        name: '北京市', 
                        code: '110000',
                        child:[
                            { 
                              name: '北京市', 
                              code: '110100' ,
                              child:[
                                  { name: '东城区', code: '110101' },
                                  { name: '西城区', code: '110102' }
                              ]
                            }
                        ],
                    },
                    {
                        name: '上海市', 
                        code: '310000',
                        child:[
                            { 
                              name: '上海市', 
                              code: '310100' ,
                              child:[
                                  { name: '黄浦区', code: '310101' },
                                  { name: '徐汇区', code: '310104' }
                              ]
                            }
                        ],
                    },
                    {
                        name: '广东省', 
                        code: '440000',
                        child:[
                            { 
                              name: '广州市', 
                              code: '440100' ,
                              child:[
                                  { name: '天河区', code: '440106' },
                                  { name: '海珠区', code: '440105' }
                              ]
                            },
                            {
                              name: '深圳市', 
                              code: '440300' ,
                              child:[
                                  { name: '福田区', code: '440304' },
                                  { name: '南山区', code: '440305' }
                              ]
                            }
                        ],
                    },
                ],
                data:{
                    province:{code:'',name:''},
                    city:{code:'',name:''},
                    area:{code:'',name:''}
                },
            };
        },
        methods: {
            // 选择后的回调
            changeArea(e){
                console.log(e);
                this.data = e;
            }
        }
    };
</script>

<style scoped>
.picker {
  padding: 20px;
  border: 1px solid #eee;
}
</style>      

API

dj-area-picker Props

参数 说明 类型 默认值
areaData 树行结构地区数据,如上相关变量定义areaData Array []
defaultCode 默认选中的省市区,如上相关变量定义defaultCode Array []

events

事件名 说明 回调参数
@change 选择后触发回调 回调参数格式如相关变量定义的data

最后

使用中有什么问题请及时反馈 谢谢 好用满意请发个好评谢谢!️

隐私、权限声明

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

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

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

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问