All Projects → 91renb → Brpickerview

91renb / Brpickerview

Licence: mit
BRPickerView 封装的是iOS中常用的选择器组件,主要包括:日期选择器(支持年月日、年月等15种日期样式选择,支持设置星期、至今等)、地址选择器(支持省市区、省市、省三种地区选择)、自定义字符串选择器(支持单列、多列、二级联动、三级联动选择)。支持自定义主题样式,适配深色模式,支持将选择器组件添加到指定容器视图。

Programming Languages

objective c
16641 projects - #2 most used programming language
ruby
36898 projects - #4 most used programming language

Projects that are alternatives of or similar to Brpickerview

Mdatepickerview
Quick and easy date picker.
Stars: ✭ 373 (-82.64%)
Mutual labels:  date, picker, datepicker, pickerview
Vue Ctk Date Time Picker
VueJS component to select dates & time, including a range mode
Stars: ✭ 707 (-67.1%)
Mutual labels:  time, date, picker, datepicker
Angular Moment Picker
Angular Moment Picker is an AngularJS directive for date and time picker using Moment.js.
Stars: ✭ 536 (-75.06%)
Mutual labels:  time, date, picker, datepicker
popoPicker
popoPicker是一个移动端3D滚轮日期时间和单项的选择器,支持无限循环滚动,不依赖第三方库
Stars: ✭ 26 (-98.79%)
Mutual labels:  time, date, datepicker, picker
React Picky Date Time
A react component for date time picker. Online demo examples
Stars: ✭ 31 (-98.56%)
Mutual labels:  time, date, picker, datepicker
react-picky-date-time
A react component for date time picker. Online demo examples
Stars: ✭ 41 (-98.09%)
Mutual labels:  time, date, datepicker, picker
Datepicker
A Date Picker with Calendar for iPhone and iPad Apps.
Stars: ✭ 103 (-95.21%)
Mutual labels:  date, picker, datepicker
Alerts And Pickers
Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date...
Stars: ✭ 5,267 (+145.09%)
Mutual labels:  picker, datepicker, pickerview
Things Calendar
Simple but elegant datepicker for the web — inspired by Things for mac
Stars: ✭ 165 (-92.32%)
Mutual labels:  date, picker, datepicker
Singledateandtimepicker
You can now select a date and a time with only one widget !
Stars: ✭ 921 (-57.14%)
Mutual labels:  time, date, picker
Horizontalpicker
DatePicker horizontal con selección smooth por día para Android.
Stars: ✭ 116 (-94.6%)
Mutual labels:  date, picker, datepicker
Date Picker
📅 Custom responsive date picker widget for Android, written in Kotlin.
Stars: ✭ 146 (-93.21%)
Mutual labels:  time, date, picker
Calendar
📆 calendar 日历
Stars: ✭ 119 (-94.46%)
Mutual labels:  date, picker, datepicker
Pickadate.js
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
Stars: ✭ 7,753 (+260.77%)
Mutual labels:  time, date, picker
Linear Time Picker
Gorgeous Android Time and Date picker library inspired by the Timely app
Stars: ✭ 613 (-71.48%)
Mutual labels:  time, date, picker
Md Date Time Picker
An implementation of Material Design Picker components in vanilla CSS, JS, and HTML
Stars: ✭ 272 (-87.34%)
Mutual labels:  time, date, picker
WatchKitTimePicker
⏱ A Time Picker data source for WatchKit that mirrors the behavior of UIDatePicker.
Stars: ✭ 37 (-98.28%)
Mutual labels:  time, picker, uidatepicker
Laydate
layDate(日期与时间组件) 是 layui 独立维护的三大组件之一
Stars: ✭ 1,066 (-50.4%)
Mutual labels:  time, date, datepicker
vue-timeselector
🕒 Simply customizable powerful time picker for Vue.js
Stars: ✭ 41 (-98.09%)
Mutual labels:  time, date, picker
Vue Datetime
Mobile friendly datetime picker for Vue. Supports date and datetime modes, i18n and more.
Stars: ✭ 928 (-56.82%)
Mutual labels:  time, date, datepicker

BRPickerView

BRPickerView 封装的是iOS中常用的选择器组件,主要包括:日期选择器(支持年月日、年月等15种日期样式选择,支持设置星期、至今等)、地址选择器(支持省市区、省市、省三种地区选择)、自定义字符串选择器(支持单列、多列、二级联动、三级联动选择)。支持自定义主题样式,适配深色模式,支持将选择器组件添加到指定容器视图。

【说明】

  • 当前最新版本为: 2.7.6
  • 如果不能找到最新版本,请先执行一下 pod repo update 更新本地仓库,待更新完成后;再执行 pod search BRPickerView 进行搜索,就会看到最新版本。

效果演示

查看并运行 BRPickerViewDemo.xcodeproj

效果图1 效果图2
框架Demo运行效果图1 框架Demo运行效果图2

安装

1. CocoaPods

  1. 在 Podfile 中添加 pod 'BRPickerView'

  2. 执行 pod installpod update

  3. 导入头文件 #import <BRPickerView.h>

2. 手动导入

  1. 将与 README.md 同级目录下的 BRPickerView 文件夹拽入项目中

  2. 导入头文件 #import "BRPickerView.h"

系统要求

  • iOS 8.0+
  • ARC

使用

1. 时间选择器:BRDatePickerView

​ 查看 BRDatePickerView.h 头文件,里面提供了两种使用方式,参见源码。

/// 日期选择器格式
typedef NS_ENUM(NSInteger, BRDatePickerMode) {
    // ----- 以下4种是系统样式(兼容国际化日期格式) -----
    /** 【yyyy-MM-dd】UIDatePickerModeDate(美式日期:MM-dd-yyyy;英式日期:dd-MM-yyyy)*/
    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】年月日(兼容国际化日期:dd-MM-yyyy)*/
    BRDatePickerModeYMD,
    /** 【yyyy-MM】年月(兼容国际化日期:MM-yyyy)*/
    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:BRDatePickerModeTime 样式2:BRDatePickerModeDate
样式1:BRDatePickerModeDate 样式2:BRDatePickerModeDateAndTime
样式3:BRDatePickerModeDateAndTime 样式4:BRDatePickerModeCountDownTimer
样式3:BRDatePickerModeTime 样式4:BRDatePickerModeCountDownTimer
  • 以下11种样式是使用 UIPickerView 类进行封装的。
样式5:BRDatePickerModeYMDHMS 样式6:BRDatePickerModeYMDHM
样式5:BRDatePickerModeYMDHMS 样式6:BRDatePickerModeYMDHM
样式7:BRDatePickerModeYMDH 样式8:BRDatePickerModeMDHM
样式7:BRDatePickerModeYMDH 样式8:BRDatePickerModeMDHM
样式9:BRDatePickerModeYMDE 样式10:BRDatePickerModeYMD
样式9:BRDatePickerModeYMD 样式10:BRDatePickerModeYM
样式11:BRDatePickerModeYM 样式12:BRDatePickerModeY
样式11:BRDatePickerModeY 样式12:BRDatePickerModeMD
样式13:BRDatePickerModeMD 样式14:BRDatePickerModeHMS
样式13:BRDatePickerModeHMS 样式14:BRDatePickerModeHM
样式15:BRDatePickerModeHM
样式15:BRDatePickerModeMS
  • 其它日期样式
设置显示星期 设置显示星期
设置显示星期:datePickerView.showWeek = YES; 设置显示星期:datePickerView.showWeek = YES;
设置添加至今 设置显示今天
设置添加至今:datePickerView.addToNow = YES; 设置显示今天:datePickerView.showToday = YES;
日期单位单行显示样式 自定义选择器选中行颜色
日期单位显示样式:datePickerView.showUnitType = BRShowUnitTypeOnlyCenter; 设置选择器中间选中行的背景颜色:selectRowColor
// 设置选择器中间选中行的样式
BRPickerStyle *customStyle = [[BRPickerStyle alloc]init];
customStyle.selectRowColor = [UIColor blueColor];
customStyle.selectRowTextFont = [UIFont boldSystemFontOfSize:20.0f];
customStyle.selectRowTextColor = [UIColor redColor];
datePickerView.pickerStyle = customStyle;
英式日期年月日 英式日期年月
样式:BRDatePickerModeYMD (默认非中文环境显示英式日期) 样式:BRDatePickerModeYM (默认非中文环境显示英式日期)
  • 几种常见的弹框样式模板
模板样式1 模板样式2
弹框样式模板1:datePickerView.pickerStyle = [BRPickerStyle pickerStyleWithThemeColor:[UIColor blueColor]]; 弹框样式模板2:datePickerView.pickerStyle = [BRPickerStyle pickerStyleWithDoneTextColor:[UIColor blueColor]];
模板样式3 添加选择器的头视图
弹框样式模板3:datePickerView.pickerStyle = [BRPickerStyle pickerStyleWithDoneBtnImage:[UIImage imageNamed:@"icon_close"]]; 添加选择器的头视图:pickerHeaderView
// 添加选择器头视图(pickerHeaderView)
UIView *headerView = [[UIView alloc]initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, 36)];
headerView.backgroundColor = [[UIColor grayColor] colorWithAlphaComponent:0.1f];
NSArray *unitArr = @[@"", @"", @""];
for (NSInteger i = 0; i < unitArr.count; i++) {
    CGFloat width = SCREEN_WIDTH / unitArr.count;
    CGFloat orginX = i * (SCREEN_WIDTH / unitArr.count);
    UILabel *label = [[UILabel alloc]initWithFrame:CGRectMake(orginX, 0, width, 36)];
    label.backgroundColor = [UIColor clearColor];
    label.textAlignment = NSTextAlignmentCenter;
    label.font = [UIFont systemFontOfSize:16.0f];
    label.textColor = [UIColor darkGrayColor];
    label.text = unitArr[i];
    [headerView addSubview:label];
}
datePickerView.pickerHeaderView = headerView;

2. 地址选择器:BRAddressPickerView

​ 查看 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

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

​ 查看 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 *stringPickerView = [[BRStringPickerView alloc]init];
stringPickerView.pickerMode = BRStringPickerComponentSingle;
stringPickerView.title = @"融资情况";
stringPickerView.dataSourceArr = [modelArr copy];
stringPickerView.selectIndex = 2;
stringPickerView.resultModelBlock = ^(BRResultModel *resultModel) {
    NSLog(@"选择的索引:%@", @(resultModel.index));
    NSLog(@"选择的值:%@", resultModel.value);
};

[stringPickerView show];


/// 3.多列字符串选择器
BRStringPickerView *stringPickerView = [[BRStringPickerView alloc]init];
stringPickerView.pickerMode = BRStringPickerComponentMulti;
stringPickerView.title = @"自定义多列字符串";
stringPickerView.dataSourceArr = @[@[@"语文", @"数学", @"英语", @"物理", @"化学", @"生物"], @[@"优秀", @"良好", @"及格", @"不及格"]];
stringPickerView.selectIndexs = @[@2, @1];
stringPickerView.resultModelArrayBlock = ^(NSArray<BRResultModel *> *resultModelArr) {
    NSLog(@"选择的值:%@", [NSString stringWithFormat:@"%@%@", resultModelArr[0].value, resultModelArr[1].value]);
};

// 设置选择器中间选中行的样式
BRPickerStyle *customStyle = [[BRPickerStyle alloc]init];
customStyle.selectRowTextFont = [UIFont boldSystemFontOfSize:20.0f];
customStyle.selectRowTextColor = [UIColor blueColor];
stringPickerView.pickerStyle = customStyle;

[stringPickerView show];
  • 字符串选择器效果图:
自定义单列字符串 融资情况
单列字符串选择器 单列字符串选择器
多列字符串选择器
多列字符串选择器

更新记录

2021-10-09(V2.7.6)

  • 适配iOS15

2021-05-28(V2.7.5)

2020-09-25(V2.7.3)

  • 适配选择器iOS14的样式:#189#191

2020-09-23(V2.7.2)

  • 日期选择器新增添加自定义字符串属性:firstRowContentlastRowContent
  • 解决日期选择器设置最小日期时,存在的联动不正确的问题:#184

2020-08-28(V2.7.0)

  • 日期选择器添加 nonSelectableDates 属性:#178
  • 优化选中行文本显示:#177

2020-08-16(V2.6.8)

  • 优化代码,适配 iPad 分屏显示
  • 新增 keyView 属性(即组件的父视图:可以将组件添加到 自己获取的 keyWindow 上,或页面的 view 上)

2020-08-09(V2.6.7)

  • 适配 iOS14

2020-08-06(V2.6.6)

2020-07-18(V2.6.5)

  • 字符串选择器新增支持多级联动选择

2020-06-24(V2.6.3)

  • 日期选择器新增属性:timeZoneaddCustomString

2020-05-12(V2.6.2)

2020-04-30(V2.6.0)

  • 新增样式属性:selectRowTextColorselectRowTextFont

  • 日期选择器新增数字显示属性:numberFullName

  • 优化代码,添加 BRDatePickerModeYMD 支持国际化英式日期

  • 修复 #143

2020-04-27(V2.5.8)

  • 修复 #138#142
  • 日期选择器新增 descending 属性,支持降序的时间列表
  • 更新地址选择器地区数据源

2020-03-31(V2.5.7)

  • 优化代码,解决已知问题

2020-02-26(V2.5.6)

  • 优化代码,兼容部分国际化日期样式

2020-02-24(V2.5.5)

  • 添加设置选择器选中行背景颜色的功能,新增属性 selectRowColor

2020-01-31(V2.5.3)

  • 新增属性:pickerHeaderViewpickerFooterView
  • 新增刷新选择器数据方法:reloadData

2020-01-05(V2.5.1)

  • 优化代码,添加 BRDatePickerModeYM 支持国际化英式日期

2020-01-02(V2.5.0)

  • 日期选择器新增属性:showUnitType(日期单位显示样式)、minuteIntervalsecondInterval
  • 封装了常用的几种模板样式,使用更加简单便捷
  • 框架内默认适配深色模式显示

2019-12-26(V2.4.6)

  • 添加支持动态更新属性 titleselectDatepickerMode 的值
  • 日期选择器添加 showWeek 属性,及新增 BRDatePickerModeMS 日期类型
  • 优化选择器【用法二】的使用,新增选择器滚动选择时回调的属性

2019-11-28(V2.4.5)

  • 日期选择器新增选择 ”至今“ 和 显示 ”今天“ 的功能,见以下两个属性:

    showToday :控制是否显示 “今天” ,默认为 NO

    addToNow:控制是否添加选择 “至今”,默认为 NO

2019-11-26(V2.4.3)

  • 日期选择器新增以下三种选择类型:

    BRDatePickerModeYMDHMS(年月日时分秒)、BRDatePickerModeYMDE(年月日星期)、BRDatePickerModeHMS(时分秒)

  • 更新地址选择器地区数据源

2019-11-07(V2.4.2)

  • 日期选择器添加:BRDatePickerModeYMDH(yyyy-MM-dd HH)类型
  • 地址选择器添加:selectIndexs 属性,可根据索引去设置默认选择
  • 适配横屏及刘海屏安全区域显示效果

2019-11-04(V2.4.0)

  • 优化选择器子目录管理,方便轻量级、模块化集成

    pod 'BRPickerView' // 集成全部的功能

    pod 'BRPickerView/DatePickerView' // 仅集成日期选择器的功能

    pod 'BRPickerView/AddressPickerView' // 仅集成地址选择器的功能

    pod 'BRPickerView/StringPickerView' // 仅集成字符串选择器的功能

2019-11-01(V2.3.8)

  • 优化代码,添加更多的自定义样式属性

2019-10-30(V2.3.6)

  • 优化代码,添加国际化支持

2019-10-26(V2.3.5)

  • 添加传统的创建对象设置属性的使用方式
  • 开放设置选择器颜色及样式,适配深色模式
  • 更新省市区数据源,数据与政府官网最新公布的一致(参见:行政区划代码
  • 支持将选择器添加到指定容器视图上(见BaseView.h文件,扩展一方法)
  • 支持将子视图添加到选择器上(见BaseView.h文件,扩展二方法)
  • 优化代码,配置Pod库的层级目录

2018-04-27(V2.2.1):

  • 修复bug,适配iPad和横屏显示。
  • 优化代码,提高框架适应性,降低内存消耗。

2018-04-03(V2.2.0)

  • 时间选择器新添加了7种显示类型(BRDatePickerMode),可根据自己项目的需求选择性使用。
  • 适配横屏,及 iPhoneX 底部安全区域。
  • 修改了最小时间和最大时间的参数名称(以前版本是传 NSString 类型, 现在传 NSDate 类型)
  • 修复比较时间大小时出现的bug。

2018-03-19(V2.1.3)

  • 修改地址选择器确认选择后的回调参数。
  • 现修改如下:可通过省市区的模型获取省市区的 name(名称)、code(id)、index(索引)resultBlock:^(BRProvinceModel *province, BRCityModel *city, BRAreaModel *area) {}
  • 去掉第三方依赖库 MJExtension ,修改为手动解析地址数据源。

2018-03-11(V2.1.2)

  • 重命名了Github用户名,更新项目相关的路径。(提示:pod之前的版本不受影响)

2018-02-28(V2.1.1)

  • 修复某些情况下无法用bundle加载本地数据源(BRCity.plist)bug。

2018-01-26(V2.1.0)

  • 给地址选择器添加了一个方法(见方法4),提供数据源参数,支持外部传入地区数据源。
  • 提示:要注意数据源格式,参考 BRCity.json。可以把 BRCity.json 文件的内容放到后台去维护,通过后台接口获取地区数据源(即 BRCity.json 文件的内容)。

2018-01-25(V2.0.0)

  • 更新了地址数据源(BRCity.plist),地区信息是2018年最新最全的,与微信的地区信息完全一致。
  • 支持自定义默认选择地址(格式:@[@"浙江省", @"杭州市", @"西湖区"]),支持下次点击进入地址选择器时,默认地址为上次选择的结果。
  • 修改了日期选择器、地址选择器、字符串选择器的接口方法(删除了之前的方法2)。
  • 添加了地址选择器显示类型,支持3种显示:只显示省份、显示省份和城市、显示省市区。

2018-01-05(V1.3.0)

  • 添加取消选择的回调方法(点击背景或取消按钮会执行 cancelBlock
  • 合并了字符串选择器 数组数据源和plist数据源对应的方法,dataSource 参数支持两种类型:

2018-01-02(V1.2.0)

  • 添加支持自定义主题颜色的方法。

2017-11-26(V1.1.0)

  • 更换第三方依赖库。
  • 用MJExtension 替换了 原来的YYModel,以前没有注意导入YYModel,同时又导入YYKit会导致重复导入而冲突(另外使用YYModel时,手动导入和pod导入 其中的头文件和方法名也不一样,所以很容易出错)。

2017-11-16(V1.0.0)

  • 初始版本!

许可证

BRPickerView 使用 MIT 许可证,详情见 LICENSE 文件。

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].