1. 框架介绍

2. 效果演示

3. 更新记录

4. 安装

4.1. CocoaPods

4.2. 手动导入

5. 系统要求

6. 使用

6.1. 时间选择器:BRDatePickerView

/**
 * 1.显示时间选择器
 *
 * @param title 标题
 * @param dateType 日期显示类型
 * @param defaultSelValue 默认选中的时间(值为空/值格式错误时,默认就选中现在的时间)
 * @param resultBlock 选择结果的回调
 *
 */
+ (void)showDatePickerWithTitle:(NSString *)title
 dateType:(BRDatePickerMode)dateType
 defaultSelValue:(NSString *)defaultSelValue
 resultBlock:(BRDateResultBlock)resultBlock;
/**
 * 2.显示时间选择器(支持 设置自动选择 和 自定义主题颜色)
 *
 * @param title 标题
 * @param dateType 日期显示类型
 * @param defaultSelValue 默认选中的时间(值为空/值格式错误时,默认就选中现在的时间)
 * @param minDate 最小时间,可为空(请使用 NSDate+BRPickerView 分类中和显示类型格式对应的方法创建 minDate)
 * @param maxDate 最大时间,可为空(请使用 NSDate+BRPickerView 分类中和显示类型格式对应的方法创建 maxDate)
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择结果的回调
 *
 */
+ (void)showDatePickerWithTitle:(NSString *)title
 dateType:(BRDatePickerMode)dateType
 defaultSelValue:(NSString *)defaultSelValue
 minDate:(NSDate *)minDate
 maxDate:(NSDate *)maxDate
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRDateResultBlock)resultBlock;
/**
 * 3.显示时间选择器(支持 设置自动选择、自定义主题颜色、取消选择的回调)
 *
 * @param title 标题
 * @param dateType 日期显示类型
 * @param defaultSelValue 默认选中的时间(值为空/值格式错误时,默认就选中现在的时间)
 * @param minDate 最小时间,可为空(请使用 NSDate+BRPickerView 分类中和显示类型格式对应的方法创建 minDate)
 * @param maxDate 最大时间,可为空(请使用 NSDate+BRPickerView 分类中和显示类型格式对应的方法创建 maxDate)
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择结果的回调
 * @param cancelBlock 取消选择的回调
 *
 */
+ (void)showDatePickerWithTitle:(NSString *)title
 dateType:(BRDatePickerMode)dateType
 defaultSelValue:(NSString *)defaultSelValue
 minDate:(NSDate *)minDate
 maxDate:(NSDate *)maxDate
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRDateResultBlock)resultBlock
 cancelBlock:(BRDateCancelBlock)cancelBlock;

NSDate *minDate = [NSDate br_setYear:1990 month:3 day:12];
NSDate *maxDate = [NSDate date];
[BRDatePickerView showDatePickerWithTitle:@"出生日期" dateType:BRDatePickerModeYMD defaultSelValue:weakSelf.birthdayTF.text minDate:minDate maxDate:maxDate isAutoSelect:YES themeColor:nil resultBlock:^(NSString *selectValue) {
 weakSelf.birthdayTF.text = selectValue;
} cancelBlock:^{
 NSLog(@"点击了背景或取消按钮");
}];

/// 弹出日期类型
typedef NS_ENUM(NSInteger, BRDatePickerMode) {
 // --- 以下4种是系统自带的样式 ---
 // UIDatePickerModeTime
 BRDatePickerModeTime, // HH:mm
 // UIDatePickerModeDate
 BRDatePickerModeDate, // yyyy-MM-dd
 // UIDatePickerModeDateAndTime
 BRDatePickerModeDateAndTime, // yyyy-MM-dd HH:mm
 // UIDatePickerModeCountDownTimer
 BRDatePickerModeCountDownTimer, // HH:mm
 // --- 以下7种是自定义样式 ---
 // 年月日时分
 BRDatePickerModeYMDHM, // yyyy-MM-dd HH:mm
 // 月日时分
 BRDatePickerModeMDHM, // MM-dd HH:mm
 // 年月日
 BRDatePickerModeYMD, // yyyy-MM-dd
 // 年月
 BRDatePickerModeYM, // yyyy-MM
 // 年
 BRDatePickerModeY, // yyyy
 // 月日
 BRDatePickerModeMD, // MM-dd
 // 时分
 BRDatePickerModeHM // HH:mm
};

6.2. 地址选择器:BRAddressPickerView

/**
 * 1.显示地址选择器
 *
 * @param defaultSelectedArr 默认选中的值(传数组,如:@[@"浙江省", @"杭州市", @"西湖区"])
 * @param resultBlock 选择后的回调
 *
 */
+ (void)showAddressPickerWithDefaultSelected:(NSArray *)defaultSelectedArr
 resultBlock:(BRAddressResultBlock)resultBlock;
/**
 * 2.显示地址选择器(支持 设置自动选择 和 自定义主题颜色)
 *
 * @param defaultSelectedArr 默认选中的值(传数组,如:@[@"浙江省", @"杭州市", @"西湖区"])
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择后的回调
 *
 */
+ (void)showAddressPickerWithDefaultSelected:(NSArray *)defaultSelectedArr
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRAddressResultBlock)resultBlock;
/**
 * 3.显示地址选择器(支持 设置选择器类型、设置自动选择、自定义主题颜色、取消选择的回调)
 *
 * @param showType 地址选择器显示类型
 * @param defaultSelectedArr 默认选中的值(传数组,如:@[@"浙江省", @"杭州市", @"西湖区"])
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择后的回调
 * @param cancelBlock 取消选择的回调
 *
 */
+ (void)showAddressPickerWithShowType:(BRAddressPickerMode)showType
 defaultSelected:(NSArray *)defaultSelectedArr
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRAddressResultBlock)resultBlock
 cancelBlock:(BRAddressCancelBlock)cancelBlock;
/**
 * 4.显示地址选择器(支持 设置选择器类型、传入地区数据源、设置自动选择、自定义主题颜色、取消选择的回调)
 *
 * @param showType 地址选择器显示类型
 * @param dataSource 地区数据源
 * @param defaultSelectedArr 默认选中的值(传数组,如:@[@"浙江省", @"杭州市", @"西湖区"])
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择后的回调
 * @param cancelBlock 取消选择的回调
 *
 */
+ (void)showAddressPickerWithShowType:(BRAddressPickerMode)showType
 dataSource:(NSArray *)dataSource
 defaultSelected:(NSArray *)defaultSelectedArr
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRAddressResultBlock)resultBlock
 cancelBlock:(BRAddressCancelBlock)cancelBlock;

// 【转换】:以@" "子字符串为基准将字符串分离成数组,如:@"浙江省 杭州市 西湖区" ——》@[@"浙江省", @"杭州市", @"西湖区"]
NSArray *defaultSelArr = [weakSelf.addressTF.text componentsSeparatedByString:@" "];
[BRAddressPickerView showAddressPickerWithShowType:BRAddressPickerModeArea defaultSelected:defaultSelArr isAutoSelect:YES themeColor:nil resultBlock:^(BRProvinceModel *province, BRCityModel *city, BRAreaModel *area) {
 weakSelf.addressTF.text = [NSString stringWithFormat:@"%@ %@ %@", province.name, city.name, area.name];
} cancelBlock:^{
 NSLog(@"点击了背景视图或取消按钮");
}];

6.3. 自定义字符串选择器:BRStringPickerView

/**
 * 1.显示自定义字符串选择器
 *
 * @param title 标题
 * @param dataSource 数据源(1.直接传数组:NSArray类型;2.可以传plist文件名:NSString类型,带后缀名,plist文件内容要是数组格式)
 * @param defaultSelValue 默认选中的行(单列传字符串,多列传一维数组)
 * @param resultBlock 选择后的回调
 *
 */
+ (void)showStringPickerWithTitle:(NSString *)title
 dataSource:(id)dataSource
 defaultSelValue:(id)defaultSelValue
 resultBlock:(BRStringResultBlock)resultBlock;
/**
 * 2.显示自定义字符串选择器(支持 设置自动选择 和 自定义主题颜色)
 *
 * @param title 标题
 * @param dataSource 数据源(1.直接传数组:NSArray类型;2.可以传plist文件名:NSString类型,带后缀名,plist文件内容要是数组格式)
 * @param defaultSelValue 默认选中的行(单列传字符串,多列传一维数组)
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择后的回调
 *
 */
+ (void)showStringPickerWithTitle:(NSString *)title
 dataSource:(id)dataSource
 defaultSelValue:(id)defaultSelValue
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRStringResultBlock)resultBlock;
/**
 * 3.显示自定义字符串选择器(支持 设置自动选择、自定义主题颜色、取消选择的回调)
 *
 * @param title 标题
 * @param dataSource 数据源(1.直接传数组:NSArray类型;2.可以传plist文件名:NSString类型,带后缀名,plist文件内容要是数组格式)
 * @param defaultSelValue 默认选中的行(单列传字符串,多列传一维数组)
 * @param isAutoSelect 是否自动选择,即选择完(滚动完)执行结果回调,传选择的结果值
 * @param themeColor 自定义主题颜色
 * @param resultBlock 选择后的回调
 * @param cancelBlock 取消选择的回调
 *
 */
+ (void)showStringPickerWithTitle:(NSString *)title
 dataSource:(id)dataSource
 defaultSelValue:(id)defaultSelValue
 isAutoSelect:(BOOL)isAutoSelect
 themeColor:(UIColor *)themeColor
 resultBlock:(BRStringResultBlock)resultBlock
 cancelBlock:(BRStringCancelBlock)cancelBlock;

// 自定义单列字符串
//NSArray *dataSource = @[@"大专以下", @"大专", @"本科", @"硕士", @"博士", @"博士后"];
NSString *dataSource = @"testData1.plist"; // 可以将数据源(上面的数组)放到plist文件中
[BRStringPickerView showStringPickerWithTitle:@"学历" dataSource:dataSource defaultSelValue:weakSelf.educationTF.text isAutoSelect:YES themeColor:nil resultBlock:^(id selectValue) {
 weakSelf.educationTF.text = selectValue;
} cancelBlock:^{
 NSLog(@"点击了背景视图或取消按钮");
}];
// 自定义多列字符串
NSArray *dataSource = @[@[@"第1周", @"第2周", @"第3周", @"第4周", @"第5周", @"第6周", @"第7周"], @[@"第1天", @"第2天", @"第3天", @"第4天", @"第5天", @"第6天", @"第7天"]];
//NSString *dataSource = @"testData3.plist"; // 可以将数据源(上面的数组)放到plist文件中
NSArray *defaultSelArr = [weakSelf.otherTF.text componentsSeparatedByString:@","];
[BRStringPickerView showStringPickerWithTitle:@"自定义多列字符串" dataSource:dataSource defaultSelValue:defaultSelArr isAutoSelect:YES themeColor:RGB_HEX(0xff7998, 1.0f) resultBlock:^(id selectValue) {
 weakSelf.otherTF.text = [NSString stringWithFormat:@"%@,%@", selectValue[0], selectValue[1]];
} cancelBlock:^{
 NSLog(@"点击了背景视图或取消按钮");
}];

7. 许可证