链氪巴士
  1. 首页
  2. 站点导航
  3. 文章
  4. 快讯
  5. 软件
  6. 书刊
  7. 关于

JFCitySelector:轻量可自定义的三级城市选择器

JFCitySelector是一个轻量、灵活且可自定义的三级城市选择器。它支持汉字、拼音搜索并有首字母索引,能自定义热门城市和最近访问,可使用现成UI或自建UI,有多种安装和使用方式,最低支持iOS8.0,使用时要注意相关配置和数据类型的要求等。

访问官网 →

JFCitySelector:轻量可自定义的三级城市选择器

一、项目简介

JFCitySelector是一个轻量、灵活且可自定义的三级城市选择器(Cityselector、Citypicker)。它具备多种功能,如支持汉字、拼音搜索,有首字母索引,可自定义热门城市,可自定义最近访问,既可以使用提供的UI界面,也能够利用提供的数据接口自己实现UI界面。这个项目最低支持iOS8.0。

二、项目安装

1. CocoaPods安装

在Podfile中添加pod ‘JFCitySelector’,然后执行pod install或者pod update,最后导入JFCitySelector.h即可。

2. 手动安装

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

三、具体使用

1. 使用已有的UI

JFCSTableViewController遵循JFCSTableViewControllerDelegate,使用initWithConfiguration:delegate:初始化JFCSTableViewController;若直接使用init初始化JFCSTableViewController,JFCSConfiguration则为默认配置。还可以对配置进行自定义,如关闭拼音搜索等,也能对热门城市进行配置。当选择城市后会有相应的操作。并且还可以自定义热门城市,返回包含特定城市模型的可变数组。

2. 使用JFCSDataOpreation提供的数据接口,自建UI

使用initWithConfiguration:,传入JFCSConfiguration实例来初始化JFCSDataOpreation,同样可以对配置进行自定义,然后通过回调获取数据源等操作。

3. 注意事项

JFCSConfiguration的属性popularCitiesMutableArray数组,元素必须是JFCSPopularCitiesModel类型;JFCSPopularCitiesModel初始化方法传入的城市名称必须要和数据源内的name对应上,因为涉及城市名称对应的code,在自定义城市前可以先打印所需城市的JFCSBaseInfoModel数据,type也必须是JFCSPopularCitiesType中的一种,分别为省级、市级和县级。

四、项目总结

JFCitySelector为iOS开发中涉及城市选择功能提供了一个不错的解决方案,它的轻量、灵活和可自定义等特性使其具有一定的优势。欢迎大家在下方留言分享自己对于这个项目的看法或者使用过程中的经验。

项目地址

GitHub链接直达