更新记录
1.0.8(2024-08-10) 下载此版本
更新使用远程数据报错的BUG
1.0.7(2024-08-10) 下载此版本
修复说明文挡错误
1.0.6(2024-08-10) 下载此版本
增加远程数据支持,解决那些不想用插件自带数据的问题
查看更多平台兼容性
uni-app
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 | 
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | - | - | - | - | - | 
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 | 
|---|---|---|---|---|---|---|---|---|---|---|
| √ | - | - | - | - | - | - | √ | - | - | - | 
hbxw-address-picker组件
介绍
一个省市区选择器组件
使用示例
<template>
    <view class="content">
        <button @click="selectAddress">选择地址</button>
        <view class="text-area" v-if="date">
            <text class="date">{{JSON.stringify(date.simple)}}</text>
            <text class="date">{{JSON.stringify(date.full)}}</text>
        </view>
        <hbxw-address-picker
            title="选择地址"
            :visible="addressPickerVisible"
            :value="address"
            @cancel="cancel"
            @sure="sure"
            @change="change"
         />
    </view>
</template>
<script>
    export default {
        data() {
            return {
                addressPickerVisible: false,
                date: null,
                address: ['广东省','珠海市','香洲区']
            }
        },
        onLoad() {
        },
        watch: {
            address(newVal) {
                console.log('---- address  ----', newVal);
            }
        },
        methods: {
            selectAddress() {
                this.addressPickerVisible = true;
            },
            cancel() {
                console.log('---- cancel ----');
            },
            sure(res) {
                console.log('---- sure ----:', res);
                this.date = res;
            },
            change(res) {
                console.log('---- change ----:', res);
                this.date = res;
            },
        }
    }
</script>
<style>
    .content {
        display: flex;
        flex-direction: column;
        align-items: center;
        justify-content: center;
    }
    .text-area {
        display: flex;
        flex-direction: column;
        justify-content: center;
        padding:0 20rpx;
    }
    .date{
        padding:20rpx 0;
        border: 1px solid rgba(0,0,0,.2);
        font-size: 28rpx;
    }
</style>
API
Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 
|---|---|---|---|---|
| value | Array | undefined | 否 | 地址选择器初始化定位项如['广东省','珠海市','香洲区'] | 
| visible | Boolean | false | 是 | 地址选择器的显示与隐藏 | 
| title | String | 选择地址 | 否 | 地址选择器标题,如果不需要传空即可 | 
| zIndex | Number | 9999 | 否 | 地址选择器的层级 | 
| data | Array | null | 否 | 地址数据 | 
| isCoustomData | Boolean | false | 否 | 是否使用外来地址数据 | 
| nameFieldName | String | name | 否 | 地址name key配置 | 
| childrenFieldName | String | children | 否 | 地址children key配置 | 
| codeFieldName | String | code | 否 | 地址code key配置 | 
注:data地址数据说明
如果要使用外来数据可以传入如下格式的数据:
// 其中name字段由nameFieldName配置 children由childrenFieldName配置 code由codeFieldName配置,根据你使用的是什么名配置的什么字符串即可
[
  {
    code: 110000000000,
    name: "北京市",
    children: [
      {
        code: 110100000000,
        name: '市轴区',
        children: [
          {
            code: 110101000000,
            name: '东城区'
          }
          ...
        ]
      }
    ]
  },
  ...
]
Events
| 事件名 | 说明 | 返回值 | 
|---|---|---|
| cancel | 点击取消按钮的触发事件 | undefined | 
| sure | 点击确认按钮的触发事件 | 举列:{simple:["内蒙古自治区","通辽市","科尔沁左翼后旗"],full:[{"name":"内蒙古自治区","code":"150000"},{"name":"通辽市","code":"150500"},{"name":"科尔沁左翼后旗","code":"150522"}] } | 
| change | picker状态发生变化触发事件 | 举列:{simple:["内蒙古自治区","通辽市","科尔沁左翼后旗"],full:[{"name":"内蒙古自治区","code":"150000"},{"name":"通辽市","code":"150500"},{"name":"科尔沁左翼后旗","code":"150522"}] } | 

                                                                    
                                                                        收藏人数:
                                    
                                                        下载插件并导入HBuilderX
                                                    
                                        赞赏(1)
                                    
                                            
                                            
 下载 9261
                
 赞赏 1
                
            
                    下载 10690111 
                
                        赞赏 1797 
                    
            
            
            
            
            
            
            
            
            
            
            
            
            
            
                        
                                赞赏
            
京公网安备:11010802035340号