更新记录

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 }

隐私、权限声明

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

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

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

许可协议

MIT协议