iOS 开发中UITableView的空数据页面、网络加载失败页

在写这篇文章共勉前，先感谢一下DZNEmptyDataSet的作者提供这个库，本篇文章是基于DZNEmptyDataSet上进行封装的，如若不允许，请联系本菜鸟，将第一时间删除。谢谢。

本菜鸟之所以封装这个页面，是因为在开发过程总，很多页面用户无操作的情况下，页面是空的、又如果仅用DZNEmptyDataSet这个，每个页面都要写很多。所以就做简单的封装，满足项目的需求。封装的也许不好，不喜勿喷，多多指教。共勉...

我的项目遇到的情景有以下情况（也是比较常用到的商城类型页面吧...）
1、无订单页面 2、购物车为空 3、无收藏页面
4、无关注页面 5、无流水页面 6、网络加载失败
还有很多无数据显示的页面... 那么这些页面不作处理的情况下...页面空空的别说用户体验差...自己的开发的过程都很讨厌...

下面进入这篇文章的正题 . . .

-------------------封装需求--------------------
1、默认空数据页面为：显示默认图片+默认文字（暂无数据）
2、网络加载失败的页面：显示加载失败的图片+文字（网络出现问题）
3、在1的基础上修改默认图片以及文字，比如：无收藏页面，显示自定义图片+文字
4、空数据页面进行操作：比如：无订单页面，显示自定义图片+文字+按钮（去逛逛，下单按钮）

以上四种情况基本满足项目需求了. . . 还是直接贴效果图. . . 代码 . . .

默认显示页面

//创建UITableView
- (void)createUI
{
    self.title = @"我的订单";
    self.xlTableView.delegate = self;
    self.xlTableView.dataSource = self;
}

修改默认显示页面图片+文字

//创建UITableView
- (void)createUI
{
    self.title = @"我的订单";
    self.xlTableView.delegate = self;
    self.xlTableView.dataSource = self;
    self.noDataImgName = @"NoOrderData";
    self.noDataTitle = @"亲，您没有订单任何订单消息哦！";
}

添加副标题

//创建UITableView
- (void)createUI
{
    self.title = @"我的订单";
    self.xlTableView.delegate = self;
    self.xlTableView.dataSource = self;
    self.noDataImgName = @"NoOrderData";
    self.noDataTitle = @"亲，您没有订单任何订单消息哦！";
    self.noDataDetailTitle = @"您购买的宝贝将会呈现在这里";
}

添加按钮

//创建UITableView
- (void)createUI
{
    self.title = @"我的订单";
    self.xlTableView.delegate = self;
    self.xlTableView.dataSource = self;
    self.noDataImgName = @"NoOrderData";
    self.noDataTitle = @"亲，您没有订单任何订单消息哦！";
    self.noDataDetailTitle = @"您购买的宝贝将会呈现在这里";
    self.btnTitle = @"马上逛逛";
    //需要修改按钮背景图片，可以这样做
    self.btnImgName = @"noOrderImage";
}

-(void)buttonEvent
{
    NSLog(@"马上逛逛");
}

第一步：下载DZNEmptyDataSet，将DZNEmptyDataSet里面的UIScrollView+EmptyDataSet.h、UIScrollView+EmptyDataSet.m拉到自己的项目中。（再次感谢该第三方的作者）

第二部：将我封装的这个类拉进去(直接copy)，然后创建的新控制器的时候，继承这个类就可以。封装的这个类继承：UIViewController

#import <UIKit/UIKit.h>

@interface XLBaseTableController : UIViewController

@property(nonatomic,retain) UITableView *xlTableView;

//是否显示空数据页面  默认为显示
@property(nonatomic,assign) BOOL isShowEmptyData;

//空数据页面的title -- 可不传，默认为：暂无任何数据
@property(nonatomic,strong) NSString *noDataTitle;
//空数据页面的图片 -- 可不传，默认图片为：NoData
@property(nonatomic,strong) NSString *noDataImgName;

//显示副标题的时候，需要赋值副标题，否则不显示
@property(nonatomic,strong) NSString *noDataDetailTitle;

//按钮标题、图片 --不常用
@property(nonatomic,strong) NSString *btnTitle;
@property(nonatomic,strong) NSString *btnImgName;

@end

#import "XLBaseTableController.h"
#import "UIScrollView+EmptyDataSet.h"

@interface XLBaseTableController ()<DZNEmptyDataSetSource, DZNEmptyDataSetDelegate>

@end

@implementation XLBaseTableController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.isShowEmptyData = YES;
    
    [self.view addSubview:self.myTableView];
    
    self.xlTableView.emptyDataSetSource = self;
    self.xlTableView.emptyDataSetDelegate = self;

}

-(UIImage *)imageForEmptyDataSet:(UIScrollView *)scrollView
{
    if (self.noDataImgName) {
        return [UIImage imageNamed:self.noDataImgName];
    }
    return [UIImage imageNamed:@"NoData"];
}

- (NSAttributedString *)titleForEmptyDataSet:(UIScrollView *)scrollView
{
    NSString *text = self.noDataTitle?self.noDataTitle:@"暂无任何数据";
    
    NSDictionary *attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:16.0f],
                                 NSForegroundColorAttributeName: [UIColor grayColor]};
    
    return [[NSAttributedString alloc] initWithString:text attributes:attributes];
}

- (NSAttributedString *)descriptionForEmptyDataSet:(UIScrollView *)scrollView
{
    NSString *text = self.noDataDetailTitle;
    
    NSMutableParagraphStyle *paragraph = [NSMutableParagraphStyle new];
    paragraph.lineBreakMode = NSLineBreakByWordWrapping;
    paragraph.alignment = NSTextAlignmentCenter;
    
    NSDictionary *attributes = @{NSFontAttributeName: [UIFont systemFontOfSize:14.0f],
                                 NSForegroundColorAttributeName: [UIColor lightGrayColor],
                                 NSParagraphStyleAttributeName: paragraph};
    
    return self.noDataDetailTitle?[[NSAttributedString alloc] initWithString:text attributes:attributes]:nil;
}

- (BOOL)emptyDataSetShouldAllowTouch:(UIScrollView *)scrollView
{
    return YES;
}

- (BOOL)emptyDataSetShouldDisplay:(UIScrollView *)scrollView
{
    return self.isShowEmptyData;
}

- (CGFloat)verticalOffsetForEmptyDataSet:(UIScrollView *)scrollView
{
    return -self.xlTableView.tableHeaderView.frame.size.height/2.0f;
}

- (NSAttributedString *)buttonTitleForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state
{
    NSDictionary *attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:16.0f]};
    
    return self.btnTitle?[[NSAttributedString alloc] initWithString:self.btnTitle attributes:attributes]:nil;
}

- (UIImage *)buttonImageForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state
{
    return self.btnImgName?[UIImage imageNamed:self.btnImgName]:nil;
}

- (void)emptyDataSet:(UIScrollView *)scrollView didTapButton:(UIButton *)button
{
    [self buttonEvent];
}

#pragma mark 按钮事件
-(void)buttonEvent
{
    
}

-(UITableView *)xlTableView
{
    if(_xlTableView == nil)
    {
        _xlTableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 0, [[UIScreen mainScreen] bounds].size.width, [[UIScreen mainScreen] bounds].size.height) style:UITableViewStyleGrouped];
        _xlTableView.tableFooterView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, [[UIScreen mainScreen] bounds].size.width, 1)];
        _xlTableView.tableHeaderView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, [[UIScreen mainScreen] bounds].size.width, 1)];
        
        _xlTableView.showsVerticalScrollIndicator = NO;
        _xlTableView.showsHorizontalScrollIndicator = NO;
    }
    
    return _xlTableView;
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
}

@end

如果此文对您作用很大，接受打赏，多多益善 . . . 肯定了我的劳动成果 . . .

总结：本封装满足了大部分项目的需求，我的项目可以说几乎都是直接继承这个类的。互相学习，这个类还可以进一步进行封装，由于时间关系，就先与大家共勉到这里。

因为是共勉的，所有都是经过重写的，目的就是为了可以让大家直接使用，不像有的作者，只提供部分代码，然后你懂的 . . . 但是本菜鸟还是建议大家自己敲一遍代码，掌握了、学习了才是自己的 . . .

由于后期会将项目中此类的封装继续整理更新上来 . . .
所以，有兴趣与本菜鸟一起共勉的，请评论收藏...
demo下载：EmptyDataHandle
欢迎关注 . . . stars