LYEmptyView使用指南

项目介绍

LYEmptyView 是一款专为iOS开发者设计的高度灵活且易用的空白页面占位图解决方案。它简化了在UITableView或UICollectionView上集成空白视图的过程，仅需一行代码就能实现无数据或无网络状态下的视觉反馈。该项目通过运行时(Runtime)和分类技术，实现了与项目的完全解耦，降低了学习成本，并允许高度定制化，支持自动显示隐藏逻辑，完美适应各种刷新场景。

项目快速启动

安装

使用CocoaPods

首先，在你的Podfile中添加以下依赖：

pod 'LYEmptyView'

然后，执行命令安装：

pod install

手动集成

1. 下载LYEmptyView仓库。
2. 将解压得到的LYEmptyView文件夹拖拽到你的Xcode项目中。
3. 导入头文件:#import "LYEmptyViewHeader.h"。

快速集成示例

在你的ViewController中，为一个UITableView集成空白页面占位图：

// 假设你有一个 UITableView 叫 tableView
self.tableView.ly_emptyView = [LYEmptyView emptyViewWithImageStr:@"noData" titleStr:@"暂无数据 点击重新加载" detailStr:@""];

如果你偏好二次封装后的简洁调用：

// 假设你已经定义了一个 MyDIYEmpty 类作为二次封装
self.tableView.ly_emptyView = [MyDIYEmpty diyNoDataEmpty];

应用案例和最佳实践

自定义显示

为了满足不同的视觉需求，你可以自定义空内容元素，包括图片、标题、描述文本以及交互按钮：

LYEmptyView *emptyView = [LYEmptyView emptyActionViewWithImageStr:@"noData"
                                                         titleStr:@"无数据"
                                                      detailStr:@"请稍后再试"
                                                   btnTitleStr:@"重新加载"];
emptyView.titleLabTextColor = [UIColor blueColor]; // 自定义标题颜色
self.tableView.ly_emptyView = emptyView;

与MJRefresh集成

如果你的项目中使用了MJRefresh，可以通过EasyEmptyTableView轻松结合LYEmptyView，在刷新完成后自动处理空视图的显示与隐藏。

动态控制显示

对于复杂逻辑，如需要根据特定条件决定何时显示空视图，可以通过手动控制显示和隐藏：

self.tableView.ly_emptyView.autoShowEmptyView = NO; // 关闭自动显示
[self.tableView ly_hideEmptyView]; // 需要时隐藏
[self.tableView ly_showEmptyView]; // 需要时显示

典型生态项目

EasyEmptyTableView: 此项目(liuxuleidota/EasyEmptyTableView)结合了LYEmptyView与MJRefresh，提供了更为便捷的方式来处理Refreshing状态下emptyView的显示逻辑。它自动化了在数据刷新前后emptyView的隐藏与显示过程，特别适合那些依赖MJRefresh进行列表滚动刷新的应用场景。

通过上述内容，开发者能够快速理解和使用LYEmptyView，无论是在简单的应用场景，还是需要深度定制的复杂场景，都能找到恰当的实践方式。