EmptyDataKit -- 一行代码集成列表视图无数据展示

抽空写了一个小东西EmptyDataKit，一行代码可以集成UITableView 和 UICollectionView 在数据源没有数据的时候展示一个默认占位图片。

gif

另外这个工具也被我添加进了我来一个叫做SBAnimation的仓库中,而且SBAnimation中的demo代码更干净和间接，而且完整的示范了这个工具的使用方法。由于精力有限，暂时还没有动力将这里的demo代码替换。所以我也将SBAnimation中的截图放到这里来。如果需要的话可以过去看看。地址

使用

0、框架依赖与BlocksKit请在podfile中添加pod 'BlocksKit'并且在终端执行pod install --no-repo-update。如果直接拖进你的工程记得添加 pod BlocksKit

1、首先 pod 'EmptyDataKit'

2、导入头文件#import <EmptyDataKit/EmptyDataKit.h>

3、在dataSource的numberOfSectionsInTableView方法中调用EmptyDataKit中的唯一方法.

{
    __weak typeof(self) weakSelf = self;
    EmptyDataKit *kit = [[EmptyDataKit alloc] initWithEdk_Image:[UIImage imageNamed:@"common_pic_loadFail"] edk_Message:@"aaa" edk_reloadHandler:^{
        [weakSelf getData];
    }];
    kit.edk_error_image = [UIImage imageNamed: @""];
    kit.edk_error_message = @"网络错误";
    self.tableView.emptyKit = kit;
}

至此，EmptyDataKit集成成功! UIcollectionView使用方法同理

另外EmptyDataKit有如下枚举

typedef NS_ENUM(NSUInteger ,EmptyDataType) {
    EDK_Loading,     // if there is a LoadingView, use this ,and also this is a default status.
    EDK_None,        // if there is some data, use this.
    EDK_Empty,       // if there is no data, use this.
    EDK_Error        // if there is some error such as network, use this.
};

这样在reloadData之前给self.tableView.emptyKit.edk_type赋值即可区分在不同状态下的不同展示情况。

实现原理

思路方面，我给UITableView和UIColectionView分别添加了两个Category, 并且通过runtime给两个类都关联了两个属性data 、 touchBlock 和emptyKit。

1
2
3

@property (nonatomic, assign) BOOL data;
@property (nonatomic, copy) TouchBlock touchBlock;
@property (nonatomic, strong) EmptyDataKit *emptyKit;

分别表示是否有数据和一个空数据的时候点击空白部分回调刷新的部分。

考虑到我想同时兼容UITableView 和 UICollectionView 所以我提取了一个object EmptyDataKit。

之前的调用方式是在numberOfSectionsInTableView方法中调用EmptyDataKit，并且是一个类方法，在新的框架下，EmptyDataKit 作为 TableView 的属性在设置的时候更加自主。

并且通过MethodSwizzling在 tableView 的 reloadData 方法中激发 EmptyDataKit,减少了很多调用次数。

+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self methodSwizzlingWithOriginalSelector:@selector(reloadData)
                               bySwizzledSelector:@selector(sure_reloadData)];
    });
}
- (void)sure_reloadData {
    [self.emptyKit edk_display:self];
//    id <UITableViewDataSource> dataSource = self.dataSource;
    [self sure_reloadData];
}

TODO：

进一步规范文档。
移除对BlocksKit的依赖。

结束语

工具已经开源在github中,欢迎提issue。

!--[**开源地址**](https://github.com/CepheusSun/EmptyDataKit)--