JFCitySelector最开始只是本身学习时写的demo(请看:iOS-(仿美团)城市选择器+自动定位+字母索引),写的很笨重(引入了一些第三方库,且使用sqlite来做为数据源),当时找的城市数据也不够齐全;一直有重写的计划,因懒癌晚期一直没具体实施,直到有次偶然发现了Administrative-divisions-of-China 中华人民共和国行政区划数据源我才下定决心去完成这个项目,最终有了如今的JFCitySelector:一个轻量、灵活、可自定义的三级城市选择器。相对于上一个版本,使用.plist做为数据源代替sqlite,城市名称拼音已预先处理写入到数据源.plist里使用时只作读取操做,因此会很快;不用在使用Masonry
和 FMDB
因此很轻量。git
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];
}
复制代码
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...
复制代码
JFCSConfiguration
的属性popularCitiesMutableArray
数组,元素必须是JFCSPopularCitiesModel
类型;JFCSPopularCitiesModel
初始化方法:initWithName: type:
,传入的城市名称必需要和数据源内的name对应上,由于牵扯到城市名称所对应的code,因此在自定义城市前能够先打印所需城市的JFCSBaseInfoModel
数据;type也必须是JFCSPopularCitiesType
,分别为JFCSPopularCitiesTypeProvince
(省级)、JFCSPopularCitiesTypeCity
(市级)和JFCSPopularCitiesTypeArea
(县级)。#Github 连接 JFCitySelector 轻量、灵活、可自定义的三级城市选择器github