BRPickerView 封装的是iOS中常用的选择器组件,主要包括:日期选择器、时间选择器、地址选择器、自定义字符串选择器。高度封装,提供了两种使用方式,支持自定义主题样式,适配深色模式。
【特别提示】:
- 当前最新版本为:
2.5.1
。 - 如果不能找到最新版本,请先执行一下
pod repo update
更新本地仓库,待更新完成后;再执行pod search BRPickerView
进行搜索,就会看到最新版本。
查看并运行 BRPickerViewDemo.xcodeproj
![]() |
![]() |
---|---|
框架Demo运行效果图1 | 框架Demo运行效果图2 |
-
在 Podfile 中添加
pod 'BRPickerView'
。 -
执行
pod install
或pod update
。 -
导入头文件
#import <BRPickerView.h>
。
-
将与
README.md
同级目录下的BRPickerView
文件夹拽入项目中 -
导入头文件
#import "BRPickerView.h"
。
- iOS 8.0+
- ARC
查看 BRDatePickerView.h 头文件,里面提供了两种使用方式,参见源码。
/// 日期选择器类型
typedef NS_ENUM(NSInteger, BRDatePickerMode) {
// ----- 以下4种是系统自带的样式 -----
/** 【yyyy-MM-dd】UIDatePickerModeDate(默认) */
BRDatePickerModeDate,
/** 【yyyy-MM-dd HH:mm】 UIDatePickerModeDateAndTime */
BRDatePickerModeDateAndTime,
/** 【HH:mm】UIDatePickerModeTime */
BRDatePickerModeTime,
/** 【HH:mm】UIDatePickerModeCountDownTimer */
BRDatePickerModeCountDownTimer,
// ----- 以下11种是自定义样式 -----
/** 【yyyy-MM-dd HH:mm:ss】年月日时分秒 */
BRDatePickerModeYMDHMS,
/** 【yyyy-MM-dd HH:mm】年月日时分 */
BRDatePickerModeYMDHM,
/** 【yyyy-MM-dd HH】年月日时 */
BRDatePickerModeYMDH,
/** 【MM-dd HH:mm】月日时分 */
BRDatePickerModeMDHM,
/** 【yyyy-MM-dd】年月日 */
BRDatePickerModeYMD,
/** 【yyyy-MM】年月 */
BRDatePickerModeYM,
/** 【yyyy】年 */
BRDatePickerModeY,
/** 【MM-dd】月日 */
BRDatePickerModeMD,
/** 【HH:mm:ss】时分秒 */
BRDatePickerModeHMS,
/** 【HH:mm】时分 */
BRDatePickerModeHM,
/** 【mm:ss】分秒 */
BRDatePickerModeMS
};
- 使用示例(参考Demo):
// 1.创建日期选择器
BRDatePickerView *datePickerView = [[BRDatePickerView alloc]init];
// 2.设置属性
datePickerView.pickerMode = BRDatePickerModeYMD;
datePickerView.title = @"选择年月日";
// datePickerView.selectValue = @"2019-10-30";
datePickerView.selectDate = [NSDate br_setYear:2019 month:10 day:30];
datePickerView.minDate = [NSDate br_setYear:1949 month:3 day:12];
datePickerView.maxDate = [NSDate date];
datePickerView.isAutoSelect = YES;
datePickerView.resultBlock = ^(NSDate *selectDate, NSString *selectValue) {
NSLog(@"选择的值:%@", selectValue);
};
// 自定义主题样式
BRPickerStyle *customStyle = [[BRPickerStyle alloc]init];
customStyle.pickerColor = BR_RGB_HEX(0xd9dbdf, 1.0f);
customStyle.pickerTextColor = [UIColor redColor];
customStyle.separatorColor = [UIColor redColor];
datePickerView.pickerStyle = customStyle;
// 3.显示
[datePickerView show];
时间选择器显示类型的效果图(默认样式):
- 以下4种样式是使用 UIDatePicker 类 进行封装的,支持循环滚动
![]() |
![]() |
---|---|
样式1:BRDatePickerModeDate | 样式2:BRDatePickerModeDateAndTime |
![]() |
![]() |
样式3:BRDatePickerModeTime | 样式4:BRDatePickerModeCountDownTimer |
- 以下11种样式是使用 UIPickerView 类 进行封装的。
【其它日期样式】:
【模板样式】:
查看 BRAddressPickerView.h 头文件,里面提供了两种使用方式,参见源码。
- 使用示例(参考Demo):
/// 地址选择器
BRAddressPickerView *addressPickerView = [[BRAddressPickerView alloc]init];
addressPickerView.pickerMode = BRAddressPickerModeArea;
addressPickerView.title = @"请选择地区";
//addressPickerView.selectValues = @[@"浙江省", @"杭州市", @"西湖区"];
addressPickerView.selectIndexs = @[@10, @0, @4];
addressPickerView.isAutoSelect = YES;
addressPickerView.resultBlock = ^(BRProvinceModel *province, BRCityModel *city, BRAreaModel *area) {
NSLog(@"选择的值:%@", [NSString stringWithFormat:@"%@ %@ %@", province.name, city.name, area.name]);
};
[addressPickerView show];
- 地址选择器的3种显示类型(showType 的3个枚举值):
![]() |
![]() |
---|---|
样式1:BRAddressPickerModeProvince | 样式2:BRAddressPickerModeCity |
![]() |
|
样式3:BRAddressPickerModeArea |
查看 BRStringPickerView.h 头文件,里面提供了两种使用方式,参见源码。
- 使用示例(参考Demo):
/// 1.单列字符串选择器(传字符串数组)
BRStringPickerView *stringPickerView = [[BRStringPickerView alloc]init];
stringPickerView.pickerMode = BRStringPickerComponentSingle;
stringPickerView.title = @"学历";
stringPickerView.dataSourceArr = @[@"大专以下", @"大专", @"本科", @"硕士", @"博士", @"博士后"];
stringPickerView.selectIndex = 2;
stringPickerView.resultModelBlock = ^(BRResultModel *resultModel) {
NSLog(@"选择的值:%@", resultModel.value);
};
[stringPickerView show];
/// 2.单列字符串选择器(传模型数组)
NSArray *infoArr = @[@{@"key": @"1001", @"value": @"无融资", @"remark": @""},
@{@"key": @"2001", @"value": @"天使轮", @"remark": @""},
@{@"key": @"3001", @"value": @"A轮", @"remark": @""},
@{@"key": @"4001", @"value": @"B轮", @"remark": @""},
@{@"key": @"5001", @"value": @"C轮以后", @"remark": @""},
@{@"key": @"6001", @"value": @"已上市", @"remark": @""}];
NSMutableArray *modelArr = [[NSMutableArray alloc]init];
for (NSDictionary *dic in infoArr) {
BRResultModel *model = [[BRResultModel alloc]init];
model.key = dic[@"key"];
model.value = dic[@"value"];
model.remark = dic[@"remark"];
[modelArr addObject:model];
}
[BRStringPickerView showPickerWithTitle:@"融资情况" dataSourceArr:[modelArr copy] selectIndex:2 resultBlock:^(BRResultModel *resultModel) {
NSLog(@"选择的索引:%@", @(resultModel.index));
NSLog(@"选择的值:%@", resultModel.value);
}];
/// 3.多列字符串选择器
BRStringPickerView *stringPickerView = [[BRStringPickerView alloc]init];
stringPickerView.pickerMode = BRStringPickerComponentMulti;
stringPickerView.title = @"自定义多列字符串";
stringPickerView.dataSourceArr = @[@[@"第1周", @"第2周", @"第3周", @"第4周", @"第5周", @"第6周", @"第7周"], @[@"第1天", @"第2天", @"第3天", @"第4天", @"第5天", @"第6天", @"第7天"]];
stringPickerView.selectIndexs = @[@2, @3];
stringPickerView.isAutoSelect = YES;
stringPickerView.resultModelArrayBlock = ^(NSArray<BRResultModel *> *resultModelArr) {
NSLog(@"选择的值:%@", [NSString stringWithFormat:@"%@,%@", resultModelArr[0].value, resultModelArr[1].value]);
};
[stringPickerView show];
- 字符串选择器效果图:
![]() |
![]() |
---|---|
单列字符串选择器 | 单列字符串选择器 |
![]() |
|
多列字符串选择器 |
- 优化字符串选择器,添加支持数据源直接传模型数组
- 日期选择器新增属性:
showUnitType
(日期单位显示样式)、minuteInterval
、secondInterval
- 封装了常用的几种模板样式,使用更加简单便捷
- 框架内默认适配深色模式显示
- 添加支持动态更新属性
title
、selectDate
、pickerMode
的值 - 日期选择器添加
showWeek
属性,及新增BRDatePickerModeMS
日期类型 - 优化选择器【用法二】的使用,新增选择器滚动选择时回调的属性
-
日期选择器新增选择 ”至今“ 和 显示 ”今天“ 的功能,见以下两个属性:
showToday
:控制是否显示 “今天” ,默认为 NOaddToNow
:控制是否添加选择 “至今”,默认为 NO
-
日期选择器新增以下三种选择类型:
BRDatePickerModeYMDHMS
(年月日时分秒)、BRDatePickerModeYMDE
(年月日星期)、BRDatePickerModeHMS
(时分秒) -
更新地址选择器地区数据源
- 日期选择器添加:BRDatePickerModeYMDH(yyyy-MM-dd HH)类型
- 地址选择器添加:selectIndexs 属性,可根据索引去设置默认选择
- 适配横屏及刘海屏安全区域显示效果
-
优化选择器子目录管理,方便轻量级、模块化集成
pod 'BRPickerView'
// 集成全部的功能pod 'BRPickerView/DatePickerView'
// 仅集成日期选择器的功能pod 'BRPickerView/AddressPickerView'
// 仅集成地址选择器的功能pod 'BRPickerView/StringPickerView'
// 仅集成字符串选择器的功能
- 优化代码,添加更多的自定义样式属性
- 优化代码,添加国际化支持
- 添加传统的创建对象设置属性的使用方式
- 开放设置选择器颜色及样式,适配深色模式
- 更新省市区数据源,数据与政府官网最新公布的一致(参见:行政区划代码)
- 支持将选择器添加到指定容器视图上(见BaseView.h文件,扩展一方法)
- 支持将子视图添加到选择器上(见BaseView.h文件,扩展二方法)
- 优化代码,配置Pod库的层级目录
- 修复bug,适配iPad和横屏显示。
- 优化代码,提高框架适应性,降低内存消耗。
- 时间选择器新添加了7种显示类型(BRDatePickerMode),可根据自己项目的需求选择性使用。
- 适配横屏,及 iPhoneX 底部安全区域。
- 修改了最小时间和最大时间的参数名称(以前版本是传 NSString 类型, 现在传 NSDate 类型)
- 修复比较时间大小时出现的bug。
- 修改地址选择器确认选择后的回调参数。
- 现修改如下:可通过省市区的模型获取省市区的 name(名称)、code(id)、index(索引)
resultBlock:^(BRProvinceModel *province, BRCityModel *city, BRAreaModel *area) {}
- 去掉第三方依赖库
MJExtension
,修改为手动解析地址数据源。
- 重命名了Github用户名,更新项目相关的路径。(提示:pod之前的版本不受影响)
- 修复某些情况下无法用bundle加载本地数据源(BRCity.plist)bug。
- 给地址选择器添加了一个方法(见方法4),提供数据源参数,支持外部传入地区数据源。
- 提示:要注意数据源格式,参考 BRCity.json。可以把 BRCity.json 文件的内容放到后台去维护,通过后台接口获取地区数据源(即 BRCity.json 文件的内容)。
- 更新了地址数据源(BRCity.plist),地区信息是2018年最新最全的,与微信的地区信息完全一致。
- 支持自定义默认选择地址(格式:@[@"浙江省", @"杭州市", @"西湖区"]),支持下次点击进入地址选择器时,默认地址为上次选择的结果。
- 修改了日期选择器、地址选择器、字符串选择器的接口方法(删除了之前的方法2)。
- 添加了地址选择器显示类型,支持3种显示:只显示省份、显示省份和城市、显示省市区。
- 添加取消选择的回调方法(点击背景或取消按钮会执行
cancelBlock
) - 合并了字符串选择器 数组数据源和plist数据源对应的方法,
dataSource
参数支持两种类型:
- 添加支持自定义主题颜色的方法。
- 更换第三方依赖库。
- 用MJExtension 替换了 原来的YYModel,以前没有注意导入YYModel,同时又导入YYKit会导致重复导入而冲突(另外使用YYModel时,手动导入和pod导入 其中的头文件和方法名也不一样,所以很容易出错)。
- 初始版本!
BRPickerView 使用 MIT 许可证,详情见 LICENSE 文件。