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

简介

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

特色

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

页面展现

项目结构

安装

CocoaPods安装

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

手动安装

• 下载 JFCitySelector 文件夹内的全部内容。
• 将 JFCitySelector 内的Classes、Resources文件夹添加(拖放)到你的工程。
• 导入 JFCitySelector.h。 #系统要求
• 该项目最低支持iOS 10.0

具体使用

一、 使用已有的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];
}
复制代码

二、 使用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 轻量、灵活、可自定义的三级城市选择器