更新记录

0.1.0（2026-03-12）

• 首次发布：省/市/区县三级地区选择弹窗
• 内置 static/location.json，导入即用
• 支持 visible 双向绑定与默认值回显

平台兼容性

uni-app(4.86)

其他

地区选择弹窗（Address Picker）

这是一个底部弹出的地区选择组件，支持 省 / 市 / 区县 三级选择。
和很多“只给 UI、数据还得你自己找”的组件不同，它把 location.json 也一并打包进插件里：你导入插件就能直接用，不需要再去拷贝地址库文件。

依赖说明（必须）

• 本组件内部使用了 uni-popup（uni 的弹出层）来实现底部抽屉效果，所以你的项目里需要已安装/可用 uni-popup。
• 如果你是从插件市场下载安装到项目中，正常会自动处理依赖；如果是手动拷贝组件文件，请同时确保项目内存在 uni_modules/uni-popup（或已集成 uni-ui 的同名组件）。

你需要传什么数据

1）控制显示

• visible：Boolean，用来控制弹窗开关（支持 :visible.sync / v-model:visible）

2）回显默认值（可选）

• value：Array，默认值/回显值，格式为地区对象数组（省、市、区县），每项结构如下：

{ name: '广东省', adcode: '440000' }

组件会返回什么

事件

• confirm(selectedItems)：点击“确定”时触发，返回长度 1~3 的数组（省/市/区县）
• input(selectedItems)：兼容老用法（同 confirm 返回一致）
• close：弹窗关闭时触发
• update:visible(false)：弹窗关闭时会同步把 visible 置为 false

Props

更新日志

见 changelog.md