Awesome

CitySelect

选择城市控件

系列

在工作之余，打算将一些常用的逻辑页面，模块，功能点做成library库，这样当有相似需求的时候，可以做到插拔式开发！现在系列中有以下内容

• App内部自动更新-AutoUpdateProject
• 选择城市-CitySelect
• 扫描二维码条形码控件-ScanCode
• 一键打开WebView件-WebViewUtils
• 简约动态权限申请库-FanPermission
• 弹出自定义支付密码输入框-InputPswDemo
• 安卓常用工具集成-AndroidUtils

优势

• 包含当前定位城市，热门城市以及城市列表的展示
• 点击重新定位可回调给调用者做定位处理
• 城市列表按照首字母A~Z排序，字母索引悬浮
• 右侧含有快速索引工具条，点击索引快速进行列表定位
• 包含城市搜索功能，包含汉字搜索，拼音搜索以及拼音首字母搜索（这个是别人不支持的）
• 使用简单，设置数据以及各种回调监听即可
• 可自由配置是否显示热门城市和当前定位城市

demo下载

Demo下载

扫描二维码下载：

效果预览

更新记录

• v1.0.4
  • 新增设置搜索框的文案提示

使用方式

• Step1 Add it in your root build.gradle at the end of repositories.

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

• Step2 Add the dependency.

  dependencies {
  		implementation 'com.github.MZCretin:CitySelect:latest_version'
  }
  

• Step3 import the view wherever you need.

  <com.cretin.tools.cityselect.view.CitySelectView
          android:id="@+id/city_view"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          app:layout_constraintBottom_toBottomOf="parent"
          app:layout_constraintLeft_toLeftOf="parent"
          app:layout_constraintRight_toRightOf="parent"
          app:layout_constraintTop_toTopOf="parent" />
  

• Step4 init data and add listeners you need.

      //设置所有城市数据
  	  final List<CityModel> allCitys = new ArrayList<>();
  	  allCitys.add(new CityModel("深圳","10000000");
  	  allCitys.add(new CityModel("深圳","10000000");
  	  allCitys.add(new CityModel("深圳","10000000");
  	  allCitys.add(new CityModel("深圳","10000000");
      ...
                  
      //设置热门城市列表 这都是瞎写的 哈哈哈
      final List<CityModel> hotCitys = new ArrayList<>();
      hotCitys.add(new CityModel("深圳", "10000000"));
      hotCitys.add(new CityModel("广州", "10000001"));
      hotCitys.add(new CityModel("北京", "10000002"));
      hotCitys.add(new CityModel("天津", "10000003"));
      hotCitys.add(new CityModel("武汉", "10000004"));
  	...
                               
      //设置当前城市数据
      final CityModel currentCity = new CityModel("深圳", "10000000");
  
      //绑定数据到视图 需要 所有城市列表 热门城市列表 和 当前城市列表 其中 所有城市列表是必传的 热门城市和当前城市是选填的 传null就不会显示对应的视图
      citySelectView.bindData(allCitys, hotCitys, currentCity);
  
      //设置搜索框的文案提示
      citySelectView.setSearchTips("请输入城市名称或者拼音");
                              
      //设置城市选择之后的事件监听
      citySelectView.setOnCitySelectListener(new OnCitySelectListener() {
         @Override
         public void onCitySelect(CityModel cityModel) {
                Toast.makeText(SelectCityActivity.this, "你点击了：" + cityModel.getCityName() + ":" + cityModel.getExtra().toString(), Toast.LENGTH_SHORT).show();
              }
  
         @Override
         public void onSelectCancel() {
                Toast.makeText(SelectCityActivity.this, "你取消了城市选择", Toast.LENGTH_SHORT).show();
              }
          });
  
      //设置点击重新定位之后的事件监听
      citySelectView.setOnLocationListener(new OnLocationListener() {
          @Override
          public void onLocation() {
              //这里模拟定位 两秒后给个随便的定位数据
              citySelectView.postDelayed(new Runnable() {
                      @Override
                      public void run() {
                          citySelectView.reBindCurrentCity(new CityModel("广州", "10000001"));
                      }
                  }, 2000);
              }
          });