更新记录
1.0.2(2026-08-12) 下载此版本
1.0.2更新
1.0.1(2026-08-12) 下载此版本
2026.08.12 更新
平台兼容性
uni-app
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 |
|---|---|---|
| × | √ | √ |
erinnerung-picker
省市区三级联动选择器,三列滚轮样式,支持底部 / 居中弹窗,内置带行政区划编码的数据(基于 cn-division 2026)。
安装
将本插件放入项目 uni_modules 目录即可,支持 easycom 自动引入。
用法
<template>
<view>
<button @click="show = true">选择地区</button>
<erinnerung-picker
:show.sync="show"
:value="codes"
:names="names"
position="center"
@confirm="onConfirm"
/>
</view>
</template>
<script>
export default {
data() {
return {
show: false,
// 二选一,或同时传(同时存在时以编码为准)
codes: [],
names: ['安徽省', '芜湖市', '无为市']
}
},
methods: {
onConfirm(e) {
// e.codes ['34','3402','340281']
// e.names ['安徽省','芜湖市','无为市']
// e.text '安徽省 芜湖市 无为市'
this.codes = e.codes
this.names = e.names
}
}
}
</script>
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| show | Boolean | false | 是否显示弹窗,支持 .sync |
| title | String | 选择地区 | 弹窗标题 |
| position | String | bottom | 弹窗位置:bottom 底部 / center 居中 |
| value | Array | [] | 编码回显,如 ['11','1101','110101'] |
| names | Array | [] | 名称回显,如 ['北京市','北京市','东城区'];与 value 同时存在时以编码为主 |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| confirm | 点击确定 | { codes, names, province, city, county, text } |
| cancel | 点击取消 / 遮罩 | - |
| update:show | 关闭时同步 | false |
| input | 确定时同步编码数组 | codes |
数据说明
组件内置的 pca-code.json 来自 cn-division 的省市区带编码 JSON,可用其最新数据直接替换本插件中的该文件以更新行政区划。
🥇 首选:cn-division(2026 年度版)
基于***地名服务(dmfw.mca.gov.cn)REST 接口最新年版数据,2026 年 4 月 26 日发布 2026.0.0 版本,与微信小程序 picker-region 数据高度一致。
- GitHub:https://github.com/kk-418/cn-division
- npm 安装:
npm install cn-division
如何更新插件内 JSON
npm install cn-division
将包内带编码的省市区文件覆盖到插件目录即可(字段均为 c / n / ch,无需再转换):
node_modules/cn-division/dist/code/pca.json
→ uni_modules/erinnerung-picker/components/erinnerung-picker/pca-code.json
组件内 pca-code.json 结构:
[{ "c": "11", "n": "北京市", "ch": [{ "c": "1101", "n": "北京市", "ch": [{ "c": "110101", "n": "东城区" }] }] }]
c:行政区划编码n:名称ch:下级列表

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 13
赞赏 0
下载 12501528
赞赏 1941
赞赏
京公网安备:11010802035340号