简介

JFCitySelector最开始只是自己学习时写的demo（请看：iOS-（仿美团）城市选择器+自动定位+字母索引），写的很笨重（引入了一些第三方库，且使用sqlite来作为数据源），当时找的城市数据也不够齐全；一直有重写的计划，因懒癌晚期一直没具体实施，直到有次偶然发现了Administrative-divisions-of-China 中华人民共和国行政区划数据源我才下定决心去完成这个项目，最终有了现在的JFCitySelector：一个轻量、灵活、可自定义的三级城市选择器。相对于上一个版本，使用.plist作为数据源代替sqlite，城市名称拼音已预先处理写入到数据源.plist里使用时只做读取操作，所以会很快；不用在使用Masonry和 FMDB所以很轻量。

特点

• 汉字、拼音搜索
• 首字母索引
• 可自定义热门城市
• 可自定义最近访问
• 可使用提供的UI界面，亦可用提供的数据接口自己实现UI界面。

页面展示

屏幕快照 2019-08-01 下午2.20.22.png

项目结构

安装

CocoaPods安装

• 在 Podfile 中添加 pod 'JFCitySelector'。
• 执行 pod install 或 pod update。
• 导入 <JFCitySelector.h>。

手动安装

• 下载 JFCitySelector 文件夹内的所有内容。
• 将 JFCitySelector 内的Classes、Resources文件夹添加(拖放)到你的工程。
• 导入 JFCitySelector.h。

系统要求

• 该项目最低支持iOS 10.0

具体使用

1、 使用已有的UI JFCSTableViewController

• 遵循JFCSTableViewControllerDelegate，
• 使用initWithConfiguration: delegate:初始化JFCSTableViewController;若直接使用 init初始化JFCSTableViewController,JFCSConfiguration则为默认配置。

 //自定义配置...
JFCSConfiguration *config = [[JFCSConfiguration alloc] init];
//关闭拼音搜索
config.isPinyinSearch = NO;
//配置热门城市
config.popularCitiesMutableArray = [self defealtPopularCities];

JFCSTableViewController *vc = [[JFCSTableViewController alloc] initWithConfiguration:config delegate:self];
[self.navigationController pushViewController:vc animated:YES];   

#pragma mark -- JFCSTableViewControllerDelegate

- (void)viewController:(JFCSTableViewController *)viewController didSelectCity:(JFCSBaseInfoModel *)model {
    //选择城市后...
     NSLog(@"name %@ code %zd pinyin %@ alias %@ firstLetter %@",model.name, model.code, model.pinyin, model.alias, model.firstLetter);
}

//自定义热门城市
- (NSMutableArray <JFCSPopularCitiesModel *> *)defealtPopularCities {
    JFCSPopularCitiesModel *bjModel = [[JFCSPopularCitiesModel alloc] initWithName:@"北京" type:JFCSPopularCitiesTypeCity];
    JFCSPopularCitiesModel *shModel = [[JFCSPopularCitiesModel alloc] initWithName:@"上海" type:JFCSPopularCitiesTypeCity];
    JFCSPopularCitiesModel *gzModel = [[JFCSPopularCitiesModel alloc] initWithName:@"广州" type:JFCSPopularCitiesTypeCity];
    JFCSPopularCitiesModel *szModel = [[JFCSPopularCitiesModel alloc] initWithName:@"深圳" type:JFCSPopularCitiesTypeCity];
    JFCSPopularCitiesModel *hzModel = [[JFCSPopularCitiesModel alloc] initWithName:@"杭州" type:JFCSPopularCitiesTypeCity];
    return [NSMutableArray arrayWithObjects:bjModel, shModel, gzModel, szModel, hzModel, nil];
}

2、 使用JFCSDataOpreation提供的数据接口，自建UI。

• 使用initWithConfiguration:，传入JFCSConfiguration实例，初始化JFCSDataOpreation

JFCSConfiguration *config = [[JFCSConfiguration alloc] init];
config.isPinyinSearch = NO;
//自定义配置...
JFCSDataOpreation *dataOpreation = [[JFCSDataOpreation alloc] initWithConfiguration:config];

[dataOpreation provinces:^(NSArray<JFCSProvince *> * _Nonnull provinces) {
    //数据源...
}];

//code...

3、注意

• JFCSConfiguration的属性popularCitiesMutableArray数组，元素必须是JFCSPopularCitiesModel类型；
• JFCSPopularCitiesModel初始化方法：initWithName: type:,传入的城市名称必须要和数据源内的name对应上，因为牵扯到城市名称所对应的code，所以在自定义城市前可以先打印所需城市的JFCSBaseInfoModel数据；type也必须是JFCSPopularCitiesType,分别为JFCSPopularCitiesTypeProvince（省级）、JFCSPopularCitiesTypeCity（市级）和JFCSPopularCitiesTypeArea（县级）。

Github 链接

JFCitySelector 轻量、灵活、可自定义的三级城市选择器