简介
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（县级）。
