pod 'JoyKit'
功能描述Demo地址:🦆
JoyKit 是笔者开发并使用了三年多的UI快速开发组件、早早就开源了不过一直懒得写文档、最近准备补一下文档、提供功能如下
1.Views(模型驱动、链式调用的TableView、CollectionView)
2.Router(模块解耦的Router路由模块、支持页面跳转、数据通讯、数据回调)
3.Views(数据驱动支持自定义工具栏的PickView、DatePickView、SegmentView)
4.Utility(打电话、发短信、发邮件、超链接的工具模块)
5.JoyQRCode(二维码扫描模块)
6.JoyMediaRecordPlay(小视频录制、播放模块)
7. JoyLocation(链式调用的定位模块(基于原生的纯定位不带UI)
8.JoyCoreMotion(运动数据、陀螺仪模块)
9.viper设计模式的基础功能模块(VC、Interactor、Presenter、Router、Model)
10.CellsLibruary(常用的15种支持自定义的列表cell)
11.Category(常用category模块 快速播放音频文件、7种CAAnimation动画、基于CALayer的转场动画、NSArray/NSDictionary防Crash以及数十种功能扩展、NSDate常用计算功能扩展、NSObject方法替换及方法映射、NSString常用功能扩展、UIButton自定义点击区域扩展、UIColor各种色纸转换方式扩展、UIImage截屏/二维码生成/裁剪/变色/存相册等快捷扩展、UITextField设置最大字数以及超限提示语、UIView常用位移/生成图片等、UIWindow亮屏监听等)
12.常用宏定义、常用类型的Block定义
功能一讲解(通过本地或服务端json配置页面UI)
json配置TableUI
PersonInteractor数据源(读取json数据源生成Table可识别的数据源(),json文件可配置cell样式、cell内、cell的事件)
@interface PersonInteractor : JoyInteractorBase
@property (nonatomic,strong)NSMutableArray *dataArrayM;
- (void)getPersonList:(VOIDBLOCK)success;
@end
@implementation JoyInteractorBase
-(NSMutableArray *)dataArrayM{
return _dataArrayM = _dataArrayM?:[NSMutableArray array];
}
- (void)getConfigData{
JoySectionBaseModel *sectionModel = [JoySectionBaseModel sectionWithHeaderModel:nil footerModel:nil cellModels:nil sectionH:0 sectionTitle:@""];
NSArray *data = (NSArray *)[[self readLocalFileWithName:@"personDetail"] objectForKey:@"style"];
for (NSDictionary *dict in data) {
JoyCellBaseModel *cellModel = [JoyCellBaseModel initWithStyle:[dict[@"style"] integerValue] obj:dict];
if(cellModel.changeKey){
[cellModel isMemberOfClass:JoyCellBaseModel.class]? cellModel.subTitle = [self.person valueForKey:cellModel.changeKey]:nil;
[cellModel isMemberOfClass:JoyTextCellBaseModel.class]? cellModel.subTitle = [self.person valueForKey:cellModel.changeKey]:nil;
[cellModel isMemberOfClass:JoySwitchCellBaseModel.class]?((JoySwitchCellBaseModel*)cellModel).on = [[self.person valueForKey:cellModel.changeKey] boolValue]:nil;
[cellModel isMemberOfClass:JoyImageCellBaseModel.class]?((JoyImageCellBaseModel*)cellModel).avatar = [self.person valueForKey:cellModel.changeKey]:nil;
}
cellModel.titleColor = @"#347AEB";
cellModel.subTitleColor = @"#CCCCCC";
[self.dataArrayM addObject:cellModel];
}
}
- (NSDictionary *)readLocalFileWithName:(NSString *)name {
// 获取文件路径
NSString *path = [[NSBundle mainBundle] pathForResource:name ofType:@"json"];
// 将文件数据化
NSData *data = [[NSData alloc] initWithContentsOfFile:path];
// 对数据进行JSON格式化并返回字典形式
return [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
}
@end
VC代码
@interface SCViewController ()
@property (nonatomic,strong)JoyTableAutoLayoutView *tableView;
@property (nonatomic,strong)PersonInteractor *interactor;
@end
@implementation SCViewController
- (void)viewDidLoad
{
[super viewDidLoad];
[self addSubViews];
[self reloadDataSource];
}
- (void)addSubViews{
[self setDefaultConstraintWithView:self.tableView andTitle:@"测试"];//setDefaultConstraintWithView自带约束不需要设置tableView的frame
}
-(void)reloadDataSource{
获取Interactor中的数据源dataArrayM
self.tableView.setDataSource(self.interactor.dataArrayM).reloadTable()即可刷新页面了
若需要实现cell上的事件可以使用Table的链式回调self.tableView.setDataSource(self.interactor.dataArrayM).reloadTable();
}
-(JoyTableAutoLayoutView *)tableView{
return _tableView = _tableView?:[[JoyTableAutoLayoutView alloc]init];
}
-(PersonInteractor *)interactor{
return _interactor = _interactor?:[[PersonInteractor alloc]init];
}
若需要实现cell上的事件可以使用Table的链式回调
self.tableView.cellTextEiditEnd(^(NSIndexPath *indexPath, NSString *content, NSString *key) {
key?[weakSelf.interactor.person setValue:content forKey:key]:nil;
})
.cellDidSelect(^(NSIndexPath *indexPath, NSString *tapAction) {
[weakSelf performTapAction:tapAction];//如json中配置某一行tapAction为@“goNextPage”,那么直接在.m中实现-(void) goNextPage 即可
})
.cellEiditAction(^(UITableViewCellEditingStyle editingStyle,NSIndexPath *indexPath) {
[JoyAlert showWithMessage:@"编辑事件"];
})
.cellMoveAction(^(NSIndexPath *sourceIndexPath,NSIndexPath *toIndexPath){
[JoyAlert showWithMessage:@"挪移事件"];
})
.cellTextCharacterHasChanged(^(NSIndexPath *indexPath, NSString *content, NSString *key){
//文本字符发生变化、开关按钮等
如person对象的key为age
[self. person setValue: content forKey: key]
});;
功能二讲解(自定义cell怎么和JoyTableAutoLayoutView配套使用)
待补充
功能三讲解(JoyRouter路由)
待补充
功能.......讲解(......)
待补充
