CYLTableViewPlaceHolder【一行代码完成“空TableView占位视图”管理】
集成后的效果使用CYLTableViewPlaceHolder
三步完成:
第一步:使用cocoaPods导入CYLTableViewPlaceHolder
在 Podfile
中如下导入:
pod 'CYLTableViewPlaceHolder'
然后使用 cocoaPods
进行安装:
建议使用如下方式:
# 不升级CocoaPods的spec仓库
pod update --verbose
第二步:遵循协议
导入头文件
#import "CYLTableViewPlaceHolder.h"
遵循协议
@interface ViewController ()<CYLTableViewPlaceHolderDelegate>
实现协议方法:
仅一个必须实现的协议方法:
创建一个自定义的占位视图并返回
@required
/*!
@brief make an empty overlay view when the tableView is empty
@return an empty overlay view
*/
- (UIView *)makePlaceHolderView;
这里注意两点:
-
CYLTableViewPlaceHolder 的
cyl_reloadData
方法内部会重新将该占位视图的 frame 进行设置,设置为与当前的的TableView
一致:包括 xy 坐标和宽高。防止TableView
位置或尺寸的变更。 - 以上步骤,包括遵循协议实现协议方法,既可以在自定义的
TableView
中去做,也可以在TableView
的代理中去做。
既可以让代理遵循协议,实现协议方法:
@interface ViewController ()<CYLTableViewPlaceHolderDelegate>
也可以让自定义的 TableView
遵循协议,实现协议方法:
@interface MyTableView ()<CYLTableViewPlaceHolderDelegate>
这里推荐在自定义的 TableView
中实现,以降低耦合性,同时也可以为 Controller 瘦身。
占位视图的点击事件等,请自行在 - (UIView *)makePlaceHolderView;
中所创建的 View 中实现。
另外,占位视图默认的设置是不能滚动的,也就不能下拉刷新了,但是如果想让占位视图可以滚动,则需要实现下面的可选代理方法。
@optional
/*!
@brief enable tableView scroll when place holder view is showing,it is disabled by default.
@attention There is no need to return NO , it will be NO by default
@return enable tableView scroll, you can only return YES
*/
- (BOOL)enableScrollWhenPlaceHolderViewShowing;
第三步:使用cyl_reloadData代替reloadData
使用方法:
仅需使用 cyl_reloadData
代替 reloadData
即可。
[self.tableView cyl_reloadData];
注意: cyl_reloadData
内部已经实现了 [self.tableView reloadData];
方法,请避免重复调用。
运行Demo
demo 的刷新组件使用的是 MJRefresh,所以需要导入相应的 CocoaPods 库
# 打开终端,进入 clone 的文件夹
cd /Users/YourUserName/Documents/CYLTableViewPlaceHolder
# 如果提示找不到库,则可去掉 --no-repo-update
pod install --verbose --no-repo-update
open CYLTableViewPlaceHolder.xcworkspace
(更多iOS开发干货,欢迎关注 微博@iOS程序犭袁 )
Posted by 微博@iOS程序犭袁
原创文章,版权声明:自由转载-非商用-非衍生-保持署名 | Creative Commons BY-NC-ND 3.0
网友评论