Android CityPicker2.0：类似美团等APP选择城市界面

CityPicker

现在使用较多的类似美团、外卖等APP的城市选择界面，一行代码搞定，就是这么简单粗暴！！！

主要功能：

• 字母悬浮栏
• 指定热门城市
• 自定义动画效果
• 自定义主题
• 名称或拼音搜索
• 返回城市名、code等数据
• 提供定位接口，解耦定位SDK

Preview

定位接口

默认主题

搜索功能

自定义主题

APK

下载demo.apk体验.

Install

Gradle:

implementation 'com.zaaach:citypicker:2.0.1'

or Maven:

  com.zaaach
  citypicker
  2.0.1
  pom

or 下载library手动导入.

Usage

CityPicker 基于DialogFragment 实现，已提供定位接口，需要APP自身实现定位。

基本使用：

Step1:

在manifest.xml中给使用CityPicker 的activity添加主题android:theme="@style/DefaultCityPickerTheme"

  ......

Step2:

注意：热门城市使用HotCity，定位城市使用LocatedCity

List hotCities = new ArrayList<>();
hotCities.add(new HotCity("北京", "北京", "101010100"));
hotCities.add(new HotCity("上海", "上海", "101020100"));
hotCities.add(new HotCity("广州", "广东", "101280101"));
hotCities.add(new HotCity("深圳", "广东", "101280601"));
hotCities.add(new HotCity("杭州", "浙江", "101210101"));
......

CityPicker.getInstance()
  .setFragmentManager(getSupportFragmentManager())  //此方法必须调用
  .enableAnimation(enable)  //启用动画效果
  .setAnimationStyle(anim)  //自定义动画
  .setLocatedCity(new LocatedCity("杭州", "浙江", "101210101")))  //APP自身已定位的城市，默认为null（定位失败）
  .setHotCities(hotCities)  //指定热门城市
  .setOnPickListener(new OnPickListener() {
    @Override
    public void onPick(int position, City data) {
      Toast.makeText(getApplicationContext(), data.getName(), Toast.LENGTH_SHORT).show();
    }
      
    @Override
    public void onLocate() {
      //开始定位，这里模拟一下定位
      new Handler().postDelayed(new Runnable() {
        @Override
        public void run() {
          //定位完成之后更新数据
          CityPicker.getInstance()
            .locateComplete(new LocatedCity("深圳", "广东", "101280601"), LocateState.SUCCESS);
        }
      }, 2000);
    }
  })
  .show();

关于自定义主题：

在style.xml 中自定义主题并且继承DefaultCityPickerTheme ，别忘了在manifest.xml 设置给activity。

CityPicker 中自定义的所有属性如下，有些属性值必须是引用类型refrence，使用时注意。

OK，enjoy it~

Changelog

v2.0.1

• 新增定位接口
• 修改返回类型为City ，可获取城市名、code等数据

v2.0.0

• 项目重构优化，结构更清晰
• 使用RecyclerView

Github地址：

https://github.com/zaaach/CityPicker欢迎star或提供建议~