更新记录

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"}] }

隐私、权限声明

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

无

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

插件不采集任何数据

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

无

许可协议

MIT协议