更新记录
1.1.0(2025-09-29)
下载此版本
支持自定义地址json数据
1.0.0(2024-12-10)
下载此版本
有问题请联系作者
平台兼容性
uni-app
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
√ |
√ |
√ |
√ |
√ |
√ |
- |
- |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
√ |
√ |
√ |
√ |
√ |
√ |
- |
√ |
√ |
√ |
√ |
其他
使用示例
<template>
<view>
<button @click="open">打开</button>
<sh-address-popup ref="popup" @select="" />
</view>
</template>
<script>
export default {
methods: {
open() {
// this.$refs.popup.open(['四川省', '成都市', '青羊区'])
// this.$refs.popup.open(['四川省'])
// this.$refs.popup.open('511000')
// this.$refs.popup.open('51')
this.$refs.popup.open()
},
(e) {
console.log('用户选中 -->', e)
},
},
}
</script>
属性 Porps
属性 |
类型 |
默认值 |
说明 |
title |
String |
请选择所在地区 |
弹窗标题 |
search |
String |
hide |
搜索框显示时机 hide-隐藏显示 always-一直显示 |
color |
String |
#1e90ff |
选中颜色 |
customInitial |
Map<String, String[]> |
|
若插件没有包含该地址映射字母,那么就需要自定义,地址首字映射字母示例 { A: ['澳'], D: ['东'] } |
remoteData |
() => TreeNode[] |
|
自定义远程数据,可以自己通过接口获取 |
props |
Object |
{ name: 'name', child: 'child', code: 'code', province: 'province', city: 'city', district: 'district'} |
自定义远程数据时取值属性映射关系, 不必全部赋值,只挑选不同的字段做映射 |
类型 TreeNode
属性名 |
类型 |
name |
String |
child |
TreeNode[] |
code |
String |
方法 Methods
方法名 |
说明 |
回调参数 |
open |
打开弹窗 |
可传入默认值省市区 地址名-['四川省', '成都市', '青羊区'] 编码-511000, 也可以传入不完整地址名 - ['四川省'] 编码-51 |
事件 Emit
事件名 |
说明 |
回调参数 |
change |
弹窗打开关闭 |
show |
select |
选中地址 |
props 映射字段,默认{ province, city, district, code } |