更新记录

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:下级列表

隐私、权限声明

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

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

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

许可协议

MIT协议

暂无用户评论。