更新记录

1.0.8(2024-08-10) 下载此版本

更新使用远程数据报错的BUG

1.0.7(2024-08-10) 下载此版本

修复说明文挡错误

1.0.6(2024-08-10) 下载此版本

增加远程数据支持,解决那些不想用插件自带数据的问题

查看更多

平台兼容性

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

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协议

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