CityPicker:3 行代码给 Android App 接上省市区三级联动选择器
【免费下载链接】citypickercitypicker城市选择器,详细的省市区地址信息,支持仿iOS滚轮实现,仿京东样式,一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker
CityPicker是开源作者crazyandcoder维护的 Android 省市区选择器组件,内置全国行政区划数据,专门解决三级联动选择器要自己造轮子的问题,适合想快速给 App 加地址、城市选择功能的新手和开发者。
为什么你需要一个省市区选择器
给 App 加收货地址页、做"选择城市"入口,省市区三级联动几乎必做。自己写的话,数据要自己找、要自己存,滚动交互和联动逻辑也要一套套搭起来,重复劳动不少。直接接入CityPicker这个现成的地址选择组件,把这些活儿都省了。
组件速览:内置数据,开箱即用
它用 Java 编写,核心就干一件事:把省市区 picker 封装好。当前版本6.0.2已把数据源更新为最新省市区行政数据,并优化了汉字转拼音的精度。
- 内置行政区划数据 → 你不用自己下载、维护一份 CSV
- 4 种展示样式(iOS 滚轮、京东列表、一级/三级城市列表)→ 按你的 UI 风格挑一个就行
- 支持自定义数据源 → 公司有接口发地址数据时,可以直接换成自己的
- 字体、颜色、背景等属性可调 → 界面跟你 App 的视觉风格对齐
- 几行代码完成集成 → 接入成本低,不容易踩坑
如何 3 行代码接入 CityPicker
第 1 步,Project 级build.gradle加上 jitpack 仓库:
allprojects { repositories { maven { url 'https://jitpack.io' } } }第 2 步,app 模块的build.gradle加入依赖:
implementation 'com.github.crazyandcoder:citypicker:6.0.2'第 3 步,在 Activity 里 new 一个CityPickerView,设置好选中回调并弹出,三级联动就有了。
适合哪些业务场景
- 电商:订单页填收货地址,用户逐级点选省市区
- 本地服务:让用户快速定位到自己所在的区县
- 社交应用:个人资料里选个所在城市
- 数据分析:收集用户地域信息,做区域统计
样式与 UI 能改到什么程度
展示样式可在iOS 风格滚轮、京东风格列表、一级城市列表和三级城市列表之间切换;数据源也能换成你自己的接口数据;字体大小、文字颜色、背景这些 UI 属性都提供自定义属性,想调整界面细节不用动源码。
动手试试
项目里附带示例工程和 wiki 文档,照着跑一遍就知道效果;有问题还可以进作者开的 QQ 交流群(417846442)提问。需要省市区三级联动的 App,3 行代码就能接上,值得先试一次。
【免费下载链接】citypickercitypicker城市选择器,详细的省市区地址信息,支持仿iOS滚轮实现,仿京东样式,一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考