简介

快速、高效地构建TableView，节省80%以上重复代码，无需设置数据源和代理。

Github地址：https://github.com/SmileZXLee/ZXTableView

ZXTableView

       

安装

通过CocoaPods安装

pod 'ZXTableView'

手动导入

• 将ZXTableView拖入项目中。

导入头文件

#import "ZXTableView.h"

---

功能&特点

• ✅ 无需设置数据源和代理，创建一个简单的tableView仅需在控制器中声明cell，headerView(非必须)，footerView(非必须)的类，然后将数据数组赋值给zxDatas，zxDatas为二级数组即为多section的情况，然后在cell中创建model(以“model”字符串结尾)，然后重写setModel即可。
• ✅ 支持在xib的tableView中设置cell，headerView(非必须)，footerView(非必须)的类名，控制器中仅需将数据数组赋值给zxDatas，后续步骤与上一条相同。
• ✅ 超丰富的tableView属性设置，支持根据具体的indexPath设置特定cell，根据具体的section设置特定的headerView和footerView，支持自动高度及自定义高度。
• ✅ 支持在cell中直接获取当前indexPath，直接获取当前tableView，支持在model中直接获取当前indexPath，支持在headerView和footerView中获取当前section等。
• ✅ 支持tableView的cell点击事件回调，滑动编辑事件回调，滚动事件回调等所有常见代理回调，支持自定义代理。
• ✅ 支持自定义系统tableView的所有代理和数据源设置(一般不需要)。

---

创建ZXTableView示例

创建一个最基础的TableView，实现点击删除按钮删除对应行

• 在TableView所在的控制器中，此处定义的cell对应模型为ZXTestSingleTbModel

//声明cell是什么类
self.tableView.zx_setCellClassAtIndexPath = ^Class (NSIndexPath *  indexPath) {
    return [ZXTestSingleTbCell class];
};
//获取cell对象并对其进行处理
__weak __typeof(self) weakSelf = self;
self.tableView.zx_getCellAtIndexPath = ^(NSIndexPath *indexPath, ZXTestSingleTbCell *cell, id model) {
    cell.delBlock = ^{
        [weakSelf.tableView.zxDatas removeObjectAtIndex:indexPath.row];
        [weakSelf.tableView reloadData];
    };
};
//设置ZXTableView的数据，dataArr即为ZXTestSingleTbModel模型数组，如果需要多个section的效果，只需要改变dataArr即可。
self.tableView.zxDatas = dataArr;

• 在ZXTestSingleTbCell中

#import "ZXTestSingleTbCell.h"
#import "ZXTestSingleTbModel.h"
@interface ZXTestSingleTbCell()
@property (weak, nonatomic) IBOutlet UIImageView *iconImgV;
@property (weak, nonatomic) IBOutlet UILabel *nameLabel;
@property (weak, nonatomic) IBOutlet UILabel *goodAtLabel;
@property (weak, nonatomic) IBOutlet UIButton *delBtn;
//若cell中有包含model的属性，则会自动将model赋值给它(如果有多个含有model字符串的属性，则赋值给第一个)
@property (strong,nonatomic) ZXTestSingleTbModel *sTbModel;
@end

//重写model的set方法即可
-(void)setSTbModel:(ZXTestSingleTbModel *)sTbModel{
    _sTbModel = sTbModel;
    self.iconImgV.image = sTbModel.iconImg;
    self.nameLabel.text = sTbModel.name;
    self.goodAtLabel.text = sTbModel.goodAt;
}

• 查看效果
  

---

创建一个含有HeaderView与FooterView的TableView

• 在TableView所在的控制器中，此处定义的cell对应模型为ZXTestSingleTbModel

//声明cell是什么类
self.tableView.zx_setCellClassAtIndexPath = ^Class (NSIndexPath *  indexPath) {
    return [ZXTestSingleTbCell class];
};
//声明HeaderView是什么类
self.tableView.zx_setHeaderClassInSection = ^Class(NSInteger section) {
    return [ZXTestHFHeaderView class];
};
//声明FooterView是什么类
self.tableView.zx_setFooterClassInSection = ^Class(NSInteger section) {
    return [ZXTestHFFooterView class];
};
//获取HeaderView对象并对其进行处理
self.tableView.zx_getHeaderViewInSection = ^(NSUInteger section, ZXTestHFHeaderView *headerView, NSMutableArray *secArr) {
    headerView.headerLabel.text = [NSString stringWithFormat:@"HeaderView--%lu",section];
};
//获取FooterView对象并对其进行处理
self.tableView.zx_getFooterViewInSection = ^(NSUInteger section, ZXTestHFFooterView *footerView, NSMutableArray *secArr) {
    footerView.footerLabel.text = [NSString stringWithFormat:@"FooterView--%lu",section];
};
//设置ZXTableView的数据，dataArr即为ZXTestSingleTbModel模型数组，dataArr中包含多个数组。
self.tableView.zxDatas = dataArr;

• 在ZXTestSingleTbCell中的处理同上
• 查看效果
  

---

创建动态高度的TableView

• 在TableView所在的控制器中，此处定义的cell对应模型为ZXTestCHTbModel

#pragma mark 设置TableView
//声明cell是什么类
self.tableView.zx_setCellClassAtIndexPath = ^Class (NSIndexPath *  indexPath) {
    return [ZXTestCHTbCell class];
};
//声明HeaderView是什么类
self.tableView.zx_setHeaderClassInSection = ^Class(NSInteger section) {
    return [ZXTestCHTbSpaceHeader class];
};
//设置ZXTableView的数据，dataArr即为ZXTestCHTbModel模型数组
self.tableView.zxDatas = dataArr;

• ZXTestCHTbCelll中的处理同上

• 在ZXTestCHTbModel.h中

@interface ZXTestCHTbModel : NSObject
@property (strong,nonatomic) UIImage *iconImg;
@property (copy,nonatomic) NSString *name;
@property (copy,nonatomic) NSString *time;
@property (copy,nonatomic) NSString *comment;
//此处声明了cellH，则ZXTableView会自动把cell高度赋值给cellH，更改cellH即可改变cell高度
@property (assign,nonatomic) CGFloat cellH;
@end

• 在ZXTestCHTbModel.m中

#import "ZXTestCHTbModel.h"

@implementation ZXTestCHTbModel
-(void)setComment:(NSString *)comment{
    _comment = comment;
    //此处comment所显示对应的Label距离左右边距离为15，字体大小为14，cell顶部显示个人信息的View高度为50，commentLabel距离上下均为10
    CGFloat commentH = [self getStrHeightWithText:comment font:[UIFont systemFontOfSize:14] viewWidth:[UIScreen mainScreen].bounds.size.width - 15 * 2];
    //将计算的cell高度赋值给cellH即可
    self.cellH = commentH + 10 * 2 + 50;
    
}
//获取文字高度
- (CGFloat)getStrHeightWithText:(NSString *)text font:(UIFont *)font viewWidth:(CGFloat)width {
    NSDictionary *attrs = @{NSFontAttributeName :font};
    CGSize maxSize = CGSizeMake(width, MAXFLOAT);
    NSStringDrawingOptions options = NSStringDrawingUsesLineFragmentOrigin | NSStringDrawingUsesFontLeading;
    CGSize size = [text boundingRectWithSize:maxSize options:options attributes:attrs context:nil].size;
    return  ceilf(size.height);
}
@end

• 查看效果
  

---

自定义TableView

• 创建ZXCustomTableView继承于ZXTableView
• 在ZXCustomTableView.m中重写zx_setTableView和zx_setCell:方法即可

@implementation ZXCustomTableView
//重写父类zx_setTableView，统一设置tableView样式和偏好
- (void)zx_setTableView{
    self.backgroundColor = [UIColor redColor];
    self.zx_autoDeselectWhenSelected = NO;
}
//重写父类zx_setTableView，统一设置cell样式和偏好
- (void)zx_setCell:(UITableViewCell *)cell{
    cell.backgroundColor = [UIColor greenColor];
}
@end

---

具体使用说明

如何快速使用

• 创建一个tableView的步骤大致分为，声明cell，声明headerView&footerView，self.tableView.zxDatas赋值，在cell中声明一个含有“model”的属性名，重写该属性的set方法即可。
• ZXTableView中的大多数方法都是zx_开头，zx_set开头代表设置tableView，例如：zx_setCellClass...即为设置(声明)cell的类是谁；zx_get开头代表从tableView中获取信息，例如zx_getCellAt...即为获取cell对象，可依据此结合下方说明快速记忆。

cell相关

声明cell

• 使用代码方式声明

self.tableView.zx_setCellClassAtIndexPath = ^Class (NSIndexPath *  indexPath) {
    //可以根据indexPath返回不同的cell
    return [MyCell class];
};

• 或在xib中设置ZXTableView的zx_cellClassName

（非必须）获取cell对象，对cell对象进行操作

self.tableView.zx_getCellAtIndexPath = ^(NSIndexPath *indexPath, id cell, id model) {
    //这里的id cell中id可以改成自己当前的cell类名(若只有一种cell)，id model中的id可以改成自己当前模型的类名(若只有一种模型)
}

以上声明cell类与获取cell可以写在同一个方法中

[self.tableView zx_setCellClassAtIndexPath:^Class(NSIndexPath *indexPath) {
    return [MyCell class];
} returnCell:^(NSIndexPath *indexPath, id cell, id model) {
    //获取cell对象
}];

(非必须)设置cell高度

//返回cell高度，ZXTableView默认会将cell高度设置为cell本身高度，也就是xib中cell的高度或纯代码中在初始化方法中设置的cell的高度，若需要改动，则可以使用以下方法实现。
self.tableView.zx_setCellHAtIndexPath = ^CGFloat(NSIndexPath *indexPath) {
    return 70;
};

滑动编辑

self.tableView.zx_editActionsForRowAtIndexPath = ^NSArray<UITableViewRowAction *> *(NSIndexPath *indexPath) {
        UITableViewRowAction *delAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleDestructive title:@"删除" handler:^(UITableViewRowAction * _Nonnull action, NSIndexPath * _Nonnull indexPath) {
            [weakSelf.tableView.zxDatas removeObjectAtIndex:indexPath.row];
            [weakSelf.tableView reloadData];
        }];
        //第0行不显示侧滑删除，其余行显示侧滑删除，这里只是为了演示控制侧滑删除行的情况
        if(indexPath.row == 0){
            return nil;
        }
        return @[delAction];
    };

设置cell高度的几种方式

• 在控制器中设置cell高度，可根据indexPath设置不同的cell高度（优先级最高，若设置了，其他高度设置方法均无效）

self.tableView.zx_setCellHAtIndexPath = ^CGFloat(NSIndexPath *indexPath) {
    return 70;
};

• 在cell中设置cell的高度（优先级最低）

//在cell的初始化方法中设置cell高度即可
self.height = 50;

• 在model中设置cell的高度（优先级第二，若设置，则在cell中设置cell的高度无效）

在model.h中

//此处声明了cellH，则ZXTableView会自动把cell高度赋值给cellH，更改cellH即可改变cell高度
@property (assign,nonatomic) CGFloat cellH;

在model.m中，在需要的时候更改cellH

//例如，可以重写cellH的set方法，将cell高度在原先基础上增加10
-(void)setCellH:(CGFloat)cellH{
    _cellH = cellH + 10;
}

在cell或model中获取当前的indexPath

• 在cell中获取当前的indexPath

//在Cell.h或Cell.m中定义属性indexPath，然后通过self.indexPath获取
@property (strong, nonatomic) NSIndexPath *indexPath;

或

//在cell中直接通过self.zx_indexPathInTableView直接获取(需要'#import "ZXTableView.h"')
 NSIndexPath *indexPath = self.zx_indexPathInTableView;

如果需要根据indexPath给cell赋值，建议重写zx_indexPathInTableView的set方法并在set方法中进行赋值，例子可参见下方headerView的示例

• 在model中获取当前的indexPath

//在Model.h或Model.m中定义属性indexPath，然后通过self.indexPath获取
@property (strong, nonatomic) NSIndexPath *indexPath;

或

//在model中直接通过self.zx_indexPathInTableView直接获取(需要'#import "ZXTableView.h"')
 NSIndexPath *indexPath = self.zx_indexPathInTableView;

---

headerView&footerView相关，此处以headerView为例

声明headerView

• 使用代码声明

//声明HeaderView是什么类
self.tableView.zx_setHeaderClassInSection = ^Class(NSInteger section) {
    return [MyHeaderView class];
};

• 或在xib中设置ZXTableView的zx_headerClassName

（非必须）获取headerView对象

//获取HeaderView对象并对其进行处理
self.tableView.zx_getHeaderViewInSection = ^(NSUInteger section, MyHeaderView *headerView, NSMutableArray *secArr) {
    headerView.headerLabel.text = [NSString stringWithFormat:@"HeaderView--%lu",section];
};

以上声明headerView类与获取headerView可以写在同一个方法中

[self.tableView zx_setHeaderClassInSection:^Class(NSInteger) {
    return [MyHeaderView cell];
} returnHeader:^(NSUInteger section, id headerView, NSMutableArray *secArr) {
  //获取headerView对象
}];

(非必须)设置headerView高度

//返回headerViewl高度，ZXTableView默认会将headerView高度设置为headerView本身高度，也就是xib中headerView的高度或纯代码中在初始化方法中设置的headerView的高度，若需要改动，则可以使用以下方法实现。
self.tableView.zx_setHeaderHInSection = ^CGFloat(NSInteger section) {
    return 100;
};

设置headerView&footerView高度的几种方式

• 在控制器中设置headerView高度

self.tableView.zx_setHeaderHInSection = ^CGFloat(NSInteger section) {
    return 100;
};

• 在headerView中设置headerView高度

//在headerView的初始化方法中设置headerView高度即可
self.height = 100;

在headerView或footerView中获取当前的section

• 在headerView中获取当前的section

//在headerView.h或headerView.m中定义属性section即可
@property (strong, nonatomic) NSNumber *section;

或

//在headerView中直接通过self.zx_sectionInTableView直接获取(需要'#import "ZXTableView.h"')
NSUInteger section = self.zx_sectionInTableView;

如果需要根据section给headerView赋值，建议重写zx_sectionInTableView的set方法并在set方法中进行赋值，如

#import "ZXTestHFHeaderView.h"
@implementation ZXTestHFHeaderView
- (void)setZx_sectionInTableView:(NSUInteger)zx_sectionInTableView{
    self.headerLabel.text = [NSString stringWithFormat:@"HeaderView--%lu",zx_sectionInTableView];;
}
@end

headerView&footerView属性相关，此处以headerView为例

• 无数据是否显示HeaderView，默认为YES

//无数据时不显示headerView
self.tableView.zx_showHeaderWhenNoMsg = NO;

• 保持headerView不变（仅初始化一次），默认为NO

//保持headerView只初始化一次，之后不再重新创建
self.tableView.zx_keepStaticHeaderView = YES;

---

tableView代理事件&偏好设置相关

• 点击了某一行cell

//点击了某一行cell
self.tableView.zx_didSelectedAtIndexPath = ^(NSIndexPath *indexPath, id model, id cell) {
  //这里的id cell中id可以改成自己当前的cell类名(若只有一种cell)，id model中的id可以改成自己当前模型的类名(若只有一种模型)
  
};

• 取消点击某一行cell

//取消点击某一行cell
self.tableView.zx_didDeSelectedAtIndexPath = ^(NSIndexPath *indexPath, id model, id cell) {
  //这里的id cell中id可以改成自己当前的cell类名(若只有一种cell)，id model中的id可以改成自己当前模型的类名(若只有一种模型)
  
};

• 禁止系统Cell自动高度 可以有效解决tableView跳动问题，默认为YES

self.tableView.zx_disableAutomaticDimension = YES;

• 无数据是否显示HeaderView，默认为YES

self.tableView.zx_showHeaderWhenNoMsg = YES;

• 无数据是否显示FooterView，默认为YES

self.tableView.zx_showFooterWhenNoMsg = YES;

• 控制获取cell回调在获取model之后，默认为NO

self.tableView.zx_fixCellBlockAfterAutoSetModel = YES;

• 当选中cell的时候是否自动调用tableView的deselectRowAtIndexPath，默认为YES

self.tableView.zx_autoDeselectWhenSelected = NO;

• 是否将所有cell的SelectionStyle设置为None，默认为NO

self.tableView.zx_makeAllCellSelectionStyleNone = YES;

scrollView相关代理

///scrollView滚动事件
@property (nonatomic, copy) void (^zx_scrollViewDidScroll)(UIScrollView *scrollView);
///scrollView缩放事件
@property (nonatomic, copy) void (^zx_scrollViewDidZoom)(UIScrollView *scrollView);
///scrollView滚动到顶部事件
@property (nonatomic, copy) void (^zx_scrollViewDidScrollToTop)(UIScrollView *scrollView);
///scrollView开始拖拽事件
@property (nonatomic, copy) void (^zx_scrollViewWillBeginDragging)(UIScrollView *scrollView);
///scrollView开始拖拽事件
@property (nonatomic, copy) void (^zx_scrollViewDidEndDragging)(UIScrollView *scrollView, BOOL willDecelerate);

tableView重写数据源与代理

//tableView的DataSource 设置为当前控制器即可重写对应数据源方法
@property (nonatomic, weak, nullable) id <UITableViewDataSource> zxDataSource;
//tableView的Delegate 设置为当前控制器即可重写对应代理方法
@property (nonatomic, weak, nullable) id <UITableViewDelegate> zxDelegate;

---

UIGet（在view中直接获取关键视图）

Cell

• 获取cell所在的tableView

//在cell中
UITableView *tableView = self.zx_tableView;

• 获取cell所在的控制器

//在cell中
UIViewController *vc = self.zx_vc;

• 获取cell所在的导航控制器

//在cell中
UINavigationController *nav = self.zx_navVc;

• 获取cell所在的ZXTableView的zxDatas可变数组

//在cell中
NSMutableArray *datas = self.zx_tableViewDatas;

HeaderView & FooterView

• 同cell

---

自动跳转

设置self.tableView.zx_autoPushConfigDictionary可以实现自动跳转

• 自动跳转仅限于点击任何cell都跳转同一控制器的情况
• 点击任何cell都跳转到TestVC，此处"vc"key大小写均可以，value则为需要跳转的控制器名

//在控制器中
self.tableView.zx_autoPushConfigDictionary = @{@"vc":@"TestVC"};

• 点击任何cell都跳转到TestVC，且将点击处的indexPath.row赋值给TestVC的myId属性

//在控制器中
self.tableView.zx_autoPushConfigDictionary = @{@"vc":@"TestVC",@"myId":@"indexPath.row"};

• 点击任何cell都跳转到TestVC，且将点击处的model.name赋值给TestVC的myName属性

//在控制器中
self.tableView.zx_autoPushConfigDictionary = @{@"vc":@"TestVC",@"myName":@"model.name"};

• 点击任何cell都跳转到TestVC，且将局部变量testValue赋值给TestVC的myTestValue属性

//在控制器中
self.tableView.zx_autoPushConfigDictionary = @{@"vc":@"TestVC",@"myTestValue":testValue};

• 通过自动跳转的配置您可以无需实现didSelect方法即可实现点击cell控制器自动跳转且自动赋值