citypicker Android Studio实现
欢迎加入轮子学习(android)交流群
群名称:轮子学习(android) 群 号:539175620
前言
在实际的项目中需要使用到省市区三级联动的功能,在网上找来找去,都没有找到一个合适的库, 所以自己就封装了一个,不需要自己添加数据源,直接引用即可,一行代码搞定城市选择。怎么简单,怎么方便,怎么来,就是这么任性!
亮点
无需自己配置省市区域的数据,不需要再进行解析之类的繁杂操作,只需引用即可,结果返回省市区和邮编等四项数据信息,如果不满意样式的话可以自己修改源码!
效果预览
应用在实际项目中效果
demo演示(下载二维码)
下载地址
使用方法
gradle引用
compile 'liji.library.dev:citypickerview:0.9.0'
代码示例
CityPicker cityPicker = new CityPicker.Builder(MainActivity.this)
.textSize(20)
.title("地址选择")
.backgroundPop(0xa0000000)
.titleBackgroundColor("#234Dfa")
.titleTextColor("#000000")
.backgroundPop(0xa0000000)
.confirTextColor("#000000")
.cancelTextColor("#000000")
.province("江苏省")
.city("常州市")
.district("天宁区")
.textColor(Color.parseColor("#000000"))
.provinceCyclic(true)
.cityCyclic(false)
.districtCyclic(false)
.visibleItemsCount(7)
.itemPadding(10)
.onlyShowProvinceAndCity(false)
.build();
cityPicker.show();
//监听方法,获取选择结果
cityPicker.setOnCityItemClickListener(new CityPicker.OnCityItemClickListener() {
@Override
public void onSelected(String... citySelected) {
//省份
String province = citySelected[0];
//城市
String city = citySelected[1];
//区县(如果设定了两级联动,那么该项返回空)
String district = citySelected[2];
//邮编
String code = citySelected[3];
}
});
使用说明
结果返回
只需传入Context便可获取选择的省市区域的信息,结果返回四项,可根据自己的实际需求进行选择。
- citySelected[0]:表示:省份信息
- citySelected[1]:表示:城市信息
- citySelected[2]:表示:区县信息
- citySelected[3]:表示:邮编信息
方法说明
- textSize(滚轮文字的大小,int 类型,默认为18)
- title(选择器标题,默认为“选择地区”)
- backgroundPop(背景,默认为半透明,16位进制颜色代码,带alpha值,如0xa0ffffff)
- titleBackgroundColor(标题栏背景,默认为灰色,#C7C7C7)
- confirTextColor(确认按钮字体颜色,默认为系统的colorPrimary颜色值)
- cancelTextColor(取消按钮字体颜色,默认为系统的colorPrimary颜色值)
- province(默认的显示省份,显示选择器后直接定位的item位置)
- city(默认的显示市,显示选择器后直接定位的item位置)
- district(默认的显示区,显示选择器后直接定位的item位置)
- textColor(滚轮文字的颜色 ,int 类型,默认为0xFF585858)
- provinceCyclic(省份的滚轮是否循环滚动)
- cityCyclic(市的滚轮是否循环滚动)
- districtCyclic(区的滚轮是否循环滚动)
- visibleItemsCount(滚轮显示的item个数,int 类型,默认为5个)
- itemPadding(滚轮item间距,默认为5dp)
- onlyShowProvinceAndCity(boolean flag)(是否只显示省份和市的两级联动,去掉区或者县)
- titleTextColor(标题文字颜色,默认为 #E9E9E9)
更新日志
V0.9.0版本更新内容(2017.01.03)
- 新增标题字体颜色的属性titleTextColor
- 修复#15问题
V0.8.0版本更新内容(2016.12.10)
V0.7.0版本更新内容(2016.11.14)
V0.6.0版本更新内容(2016.11.09)
- 修复部分城市数据不全的问题
- 添加修改标题的属性
V0.5.0版本更新内容(2016.10.28)
- 修复当数据源少于7个item时,设置字体颜色有阴影的bug
V0.4.0版本更新内容(2016.10.24)
- 新增只显示省市两级联动设置
- 新增确认和取消按钮文字颜色的设置
- 新增设置默认省市区的设置
V0.3.0版本更新内容(2016.10.13)
- 新增item间距属性
- 拆分省市区三个滚轮循环显示为分别是否循环滚动
- 优化代码结构
V0.2.0版本更新内容(2016.05.16)
- 滚轮是否循环滚动
- 新增文字颜色修改
- 新增文字大小修改
- 新增滚轮内容可见数量
V0.1.0版本更新内容(2016.05.08)
- 直接传入context获取省市区信息