FORScrollViewEmptyAssistant
截图
示例
要运行示例项目，克隆仓库，然后首先从 Example 目录运行 pod install。
block 配置
// easy emptyview's layout
[self.tableview emptyViewConfigerBlock:^(FOREmptyAssistantConfiger *configer) {
configer.emptyTitle = @"Hello World";
configer.emptySubtitle = @"Talk is cheap. Show me the code";
configer.emptyImage = [UIImage imageNamed:@"image_empty"];
}];
// complicated
typeof(self) weakSelf = self;
[self.tableview emptyViewConfigerBlock:^(FOREmptyAssistantConfiger *configer) {
configer.emptyTitle = @"Hello World";
configer.emptySubtitle = @"Talk is cheap. Show me the code";
configer.emptyImage = [UIImage imageNamed:@"image_empty"];
configer.imageAnimation = imageAnimation;
configer.emptyBtnTitle = @"Request Net";
configer.emptyBtnClickBlock = ^{
[weakSelf.tableview.mj_header beginRefreshing];
};
}];自定义视图作为空视图
typeof(self) weakSelf = self;
FOREmptyAssistantConfiger *configer = [FOREmptyAssistantConfiger new];
configer.emptyTitle = @"This is demo";
configer.emptySubtitle = @"tap this to request network \n hurry up";
configer.emptyViewTapBlock = ^{
[weakSelf.tableview.mj_header beginRefreshing];
};
[self.tableview emptyViewConfiger:configer];自定义视图作为空视图
UIView *customView = [[[NSBundle mainBundle] loadNibNamed:@"FORCustomCell" owner:nil options:nil] firstObject];
FOREmptyAssistantConfiger *configer = [FOREmptyAssistantConfiger new];
configer.customView = customView;
[self.tableview emptyViewConfiger:configer];
需求
**声明：**本库是基于DZNEmptyDataSet的基础上做的封装，目的就是：
- 简化TableView和CollectionView上的使用
- 提高灵活性，根据不同状态切换不同的空白页（例如：网络失败 / 请求成功的空数据）。
说明：DZNEmptyDataSet及本库的封装都是基于dataSource的array数组为空时才回展示，更确切的说是cell的个数为零。
**提醒：**除了TableView和CollectionView初始化不需要reload，其他情况下数据为空时需要触发reloadData方法来呈现空白页占位图，内部swizzle了reloadData方法。
TableView几乎在所有的项目中都需要用到,那呈现出的空数据或者网络连接失败状态下的TableView或CollectionView要是没有做相对应的说明，使用者很容易会迷惑甚至不知所措，并且大量的列表存在为空的可能性时需要我们做大量的配置也是一件很繁琐的事情，这就是这个库要解决的问题
使用空白页占位图的***优点***：
- 避免了整片空白的视图，解释为什么当前空白页是这样的
- 可以添加一些交互回调事件
- 避免了强类型提示的突兀出现（UIAlerView、HUDProgress等等）
- 更快引导用户入门
- 使用logo加深品牌的影响
特性
- >= iOS6.0
- iPhone 和 iPad
- 仅限于在TableView和CollectionView上使用
- 对应元素包括emptyImage、emptyTitle、emptySubtitle、emptyButton
- 支持自动布局和屏幕旋转（Autolayout）
- 可以调整以下属性：
| 属性 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| DataSource | |||
| emptyTitle | NSString | 标题 | @"" |
| emptyTitleFont | UIFont | 标题字体 | systemFontOfSize:17.0f |
| emptyTitleColor | UIColor | 标题颜色 | darkGrayColor |
| emptySubtitle | NSString | 副标题 | @"" |
| emptySubtitleFont | UIFont | 副标题字体 | systemFontOfSize:15.0f |
| emptySubtitleColor | UIColor | 副标题颜色 | lightGrayColor |
| emptyImage | UIImage | 空白页占位图 | nil |
| emptyBtnTitle | NSString | 按钮标题 | @"" |
| emptyBtntitleFont | UIFont | 按钮字体 | systemFontOfSize:17.0f |
| emptyBtnTitleColor | UIColor | 按钮标题颜色 | whiteColor |
| emptyBtnImage | UIImage | 按钮icon | nil |
| emptyBtnBackgroundImage | UIImage | 按钮背景图片 | blank_button |
| customView | UIView | 自定义空白view（则前面设置的样式全部失效） | nil |
| emptyVerticalOffset | CGFloat | 空白页整体位置默认是在tableView居中显示 | 0 |
| emptySpaceHeight | CGFloat | 空白页的图片、按钮、文案之间的间距大小 | 20 |
| Delegate | |||
| allowScroll | BOOL | 添加空白页后ScrollView是否可以继续拖拽 | YES |
| userInteractionEnabled | BOOL | 可交互 | YES |
| shouldDisplay | BOOL(^)() | 添加空白页后ScrollView是否可以展示 | YES |
| shouldStartImageViewAnimate | BOOL(^)() | 空白页的图片是否执行动画 | YES |
| imageAnimation | CAAnimation | 图片的动画, Note: shouldStartAnimate==NO | |
| emptyViewTapBlock | void(^)() | 空白页区域点击 | / |
| emptyBtnClickBlock | void(^)() | 按钮点击 | / |
| 生命周期 | |||
| emptyViewWillAppear | void(^)() | 生命周期 | / |
| emptyViewWillDisappear | void(^)() | 生命周期 | / |
| emptyViewDidAppear | void(^)() | 生命周期 | / |
| emptyViewDidDisappear | void(^)() | 生命周期 | / |
安装
FORScrollViewEmptyAssistant 可以通过 CocoaPods 使用。要安装它，只需在 Podfile 中添加以下行
pod 'FORScrollViewEmptyAssistant'作者
XcodeYang, [email protected]
许可证
FORScrollViewEmptyAssistant 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。