更新记录
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"}] } |