citypicker一分钟实现省市县三级联动Android选择器控件

citypicker Android Studio实现

• 欢迎关注微信公众号、长期为您推荐优秀博文、开源项目、视频

• 微信公众号名称：Android干货程序员

• 

前言

在实际的项目中需要使用到省市区三级联动的功能，在网上找来找去，都没有找到一个合适的库， 所以自己就封装了一个，不需要自己添加数据源，直接引用即可，一行代码搞定城市选择。怎么简单，怎么方便，怎么来，就是这么任性！

亮点

1. 无需自己配置省市区域的数据，不需要再进行解析之类的繁杂操作，只需引用即可，结果返回省市区和邮编等四项数据信息，如果不满意样式的话可以自己修改源码！
2. 多种样式选择，高仿iOS滚轮实现以及列表选择。

效果预览

应用在实际项目中效果

1、高仿iOS滚轮实现城市选择器

2、城市列表选择器

demo演示(下载二维码)

下载地址

http://fir.im/r3dp

使用方法

第一步. 在项目的根目录build.gradle添加依赖

allprojects {
    repositories {
       ......
        maven { url "https://jitpack.io" }
    }
}

第二步. 在Module的build.gradle添加依赖

compile 'com.github.open-android:citypicker:0.1.0'

代码示例

1、城市列表选择器代码

友情提醒：

列表选择器的原理主要就是通过startActivityForResult方法来实现的，如果不熟悉startActivityForResult的应用，请自行解决。

//首先跳转到列表页面，通过startActivityForResult实现页面跳转传值
Intent intent = new Intent(MainActivity.this, CityListSelectActivity.class);
startActivityForResult(intent, CityListSelectActivity.CITY_SELECT_RESULT_FRAG);

//接收选择器选中的结果：
@Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == CityListSelectActivity.CITY_SELECT_RESULT_FRAG) {
            if (resultCode == RESULT_OK) {
                if (data == null) {
                    return;
                }
                Bundle bundle = data.getExtras();

                CityInfoBean cityInfoBean = (CityInfoBean) bundle.getParcelable("cityinfo");

                if (null == cityInfoBean)
                    return;

                //城市名称
                String cityName = cityInfoBean.getName();
                //纬度
                String latitude = cityInfoBean.getLongitude();
                //经度
                String longitude = cityInfoBean.getLatitude();

				//获取到城市名称，经纬度值后可自行使用...
            }
        }
    }

2、高仿iOS滚轮实现选择器代码

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]; 
                    }
		    
		    @Override
                    public void onCancel() {
                        Toast.makeText(MainActivity.this, "已取消", Toast.LENGTH_LONG).show();
                    }
                });

结果返回

只需传入Context便可获取选择的省市区域的信息，结果返回四项，可根据自己的实际需求进行选择。

1. citySelected[0]：表示：省份信息
2. citySelected[1]：表示：城市信息
3. citySelected[2]：表示：区县信息
4. citySelected[3]：表示：邮编信息

高仿iOS滚轮实现方法说明

1. textSize（滚轮文字的大小，int 类型，默认为18）
2. title（选择器标题，默认为“选择地区”）
3. backgroundPop（背景，默认为半透明，16位进制颜色代码，带alpha值，如0xa0ffffff）
4. titleBackgroundColor（标题栏背景，默认为灰色，#C7C7C7）
5. confirTextColor（确认按钮字体颜色，默认为系统的colorPrimary颜色值）
6. cancelTextColor（取消按钮字体颜色，默认为系统的colorPrimary颜色值）
7. province（默认的显示省份，显示选择器后直接定位的item位置）
8. city（默认的显示市，显示选择器后直接定位的item位置）
9. district（默认的显示区，显示选择器后直接定位的item位置）
10. textColor（滚轮文字的颜色 ，int 类型，默认为0xFF585858）
11. provinceCyclic（省份的滚轮是否循环滚动）
12. cityCyclic（市的滚轮是否循环滚动）
13. districtCyclic（区的滚轮是否循环滚动）
14. visibleItemsCount（滚轮显示的item个数，int 类型，默认为5个）
15. itemPadding（滚轮item间距，默认为5dp）
16. onlyShowProvinceAndCity(boolean flag)（是否只显示省份和市的两级联动，去掉区或者县）
17. titleTextColor(标题文字颜色，默认为 #E9E9E9)

感谢

  原文：https://github.com/crazyandcoder/citypicker