Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zhifenx/JFCitySelector
轻量、灵活、可自定义的三级城市选择器
https://github.com/zhifenx/JFCitySelector
Last synced: about 1 month ago
JSON representation
轻量、灵活、可自定义的三级城市选择器
- Host: GitHub
- URL: https://github.com/zhifenx/JFCitySelector
- Owner: zhifenx
- License: mit
- Created: 2016-11-25T06:25:56.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-07-30T07:30:50.000Z (over 4 years ago)
- Last Synced: 2024-10-28T11:52:02.350Z (about 2 months ago)
- Language: Objective-C
- Homepage:
- Size: 592 KB
- Stars: 356
- Watchers: 3
- Forks: 60
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-iOS - JFCitySelector - 轻量、灵活、可自定义的三级城市选择器 (UI Components)
README
# JFCitySelector
[](https://cocoapods.org/pods/JFCitySelector)
[](https://cocoapods.org/pods/JFCitySelector)
[](https://cocoapods.org/pods/JFCitySelector)
# 简介
[JFCitySelector](https://github.com/zhifenx/JFCitySelector)
是一个轻量、灵活、可自定义的三级城市选择器（City selector、City picker）。
# 特点
* 汉字、拼音搜索
* 首字母索引
* 可自定义热门城市
* 可自定义最近访问
* 可使用提供的UI界面，亦可用提供的数据接口自己实现UI界面。
# 页面展示
# 项目结构
# 安装
##### CocoaPods安装
* 在 Podfile 中添加 pod 'JFCitySelector'。
* 执行 pod install 或 pod update。
* 导入 JFCitySelector.h。
##### 手动安装
* 下载 JFCitySelector 文件夹内的所有内容。
* 将 JFCitySelector 内的Classes、Resources文件夹添加(拖放)到你的工程。
* 导入 JFCitySelector.h。
##### 系统要求
* 该项目最低支持iOS 8.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 *)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 * _Nonnull provinces) {
//数据源...
}];
//code...
```
##### 3、注意
* `JFCSConfiguration `的属性`popularCitiesMutableArray `数组，元素必须是`JFCSPopularCitiesModel `类型；
* `JFCSPopularCitiesModel `初始化方法：`initWithName: type:`,传入的城市名称必须要和数据源内的name对应上，因为牵扯到城市名称所对应的code，所以在自定义城市前可以先打印所需城市的`JFCSBaseInfoModel `数据；type也必须是`JFCSPopularCitiesType`,分别为`JFCSPopularCitiesTypeProvince`（省级）、`JFCSPopularCitiesTypeCity`（市级）和`JFCSPopularCitiesTypeArea`（县级）。
## 简书
[JFCitySelector轻量、灵活、可自定义的三级城市选择器
](https://www.jianshu.com/p/413db5c2480b)
## 许可证
JFCitySelector 使用 MIT 许可证，详情见 LICENSE 文件。