Latest 1.0.5
Homepage https://github.com/SmileZXLee/ZXTableView
License MIT
Platforms ios 8.0, requires ARC
Authors

安装

通过CocoaPods安装

pod 'ZXTableView'

手动导入

  • 将ZXTableView拖入项目中。

导入头文件

#import "ZXTableView.h"

创建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;
}

* 查看效果
<img src="http://www.zxlee.cn/ZXTableViewDemoImg/singleDemo.png"/>

***

### 创建一个含有HeaderView与FooterView的TableView
* 在TableView所在的控制器中,此处定义的cell对应模型为ZXTestSingleTbModel
```objective-c
//声明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 = .size;
    return ceilf(size.height);
    }
    @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];
    };
  • 获取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];
    };

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

  • 声明headerView
    //声明HeaderView是什么类
    self.tableView.zx_setHeaderClassInSection = ^Class(NSInteger section) {
    return [MyHeaderView class];
    };
  • 获取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;
    };

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

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

};

* 取消点击某一行cell
```objective-c
//取消点击某一行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;
  • 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;

Other

设置cell高度的几种方式

  • 在控制器中设置cell高度,可根据indexPath设置不同的cell高度
    self.tableView.zx_setCellHAtIndexPath = ^CGFloat(NSIndexPath *indexPath) {
    return 70;
    };
  • 在cell中设置cell的高度
    //在cell的初始化方法中设置cell高度即可
    self.height = 50;
  • 在model中设置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;
}

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

  • 在控制器中设置headerView高度
    self.tableView.zx_setHeaderHInSection = ^CGFloat(NSInteger section) {
    return 100;
    };
  • 在headerView中设置headerView高度
    //在headerView的初始化方法中设置headerView高度即可
    self.height = 100;

在cell或model中获取当前的indexPath

  • 在cell中获取当前的indexPath
    //在Cell.h或Cell.m中定义属性indexPath即可
    @property (strong, nonatomic) NSIndexPath *indexPath;
  • 在model中获取当前的indexPath
    //在Model.h或Model.m中定义属性indexPath即可
    @property (strong, nonatomic) NSIndexPath *indexPath;

ZXTableViewConfig

///model默认去匹配的cell高度属性名 若不存在则动态生成cellHRunTime的属性名
static NSString *const CELLH = @"cellH";
///cell会自动赋值包含“model”的属性
static NSString *const DATAMODEL = @"model";
///model与cell的index属性,存储当前model与cell所属的indexPath
static NSString *const INDEX = @"indexPath";
///若ZXBaseTableView无法自动获取cell高度(zxdata有值即可),且用户未自定义高度,则使用默认高度
static CGFloat const CELLDEFAULTH = 44;

#pragma mark - TableView默认偏好配置
///无数据是否显示HeaderView,默认为YES
static BOOL const ShowHeaderWhenNoMsg = YES;
///无数据是否显示FooterView,默认为YES
static BOOL const ShowFooterWhenNoMsg = YES;
///禁止系统Cell自动高度 可以有效解决tableView跳动问题,默认为YES
static BOOL const DisableAutomaticDimension = YES;
///分割线样式,默认为UITableViewCellSeparatorStyleNone
static BOOL const DefaultSeparatorStyle =  UITableViewCellSeparatorStyleNone;

感谢使用,有任何问题欢迎随时issue我

Latest podspec

{
    "name": "ZXTableView",
    "version": "1.0.5",
    "summary": "u5febu901fu6784u5efaTableView",
    "homepage": "https://github.com/SmileZXLee/ZXTableView",
    "license": "MIT",
    "authors": {
        "u674eu5146u7965": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/SmileZXLee/ZXTableView.git",
        "tag": "1.0.5"
    },
    "source_files": "ZXTableView/**/*",
    "requires_arc": true
}

Pin It on Pinterest

Share This