美文网首页iOS开发文章iOS菜鸟到大神iOS开发系列
一行代码完成“空TableView占位视图”管理

一行代码完成“空TableView占位视图”管理

作者: iOS程序犭袁 | 来源:发表于2015-12-23 16:54 被阅读5935次

    CYLTableViewPlaceHolder【一行代码完成“空TableView占位视图”管理】

    集成后的效果

    使用CYLTableViewPlaceHolder

    三步完成:

    1. 第一步:使用cocoaPods导入CYLTableViewPlaceHolder
    2. 第二步:遵循协议
    3. 第三步:使用cyl_reloadData代替reloadData

    第一步:使用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;
    

    这里注意两点:

    1. CYLTableViewPlaceHoldercyl_reloadData方法内部会重新将该占位视图的 frame 进行设置,设置为与当前的的 TableView 一致:包括 xy 坐标和宽高。防止 TableView 位置或尺寸的变更。
    2. 以上步骤,包括遵循协议实现协议方法,既可以在自定义的 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

    相关文章

      网友评论

      • 鬼崇祟:如果tableview有一个一定存在的header,那么怎么能让占位图在空白位置的中心呢
      • ethan_cun:楼主用过类似shimmerlayout的占位第三方吗 ios原生库
      • 男神nick:样式可以修改吗 然后这个里面的加载数据的方法在那个地啊
      • 对酒当歌的夜:加载完成没有数据,和加载失败(404等)这些不一样的可以给几种自定义方法,
      • 对酒当歌的夜:看起来不错,这东西自己写一个也不难
      • angelen:额,这个能不能在其他情况比如网络没开之类的情况现实占位呢?
      • 口袋海贼王_:cyl_reloadData 能不能保持原生,这样看起来不舒服啊。 :smiley:
        口袋海贼王_:@晋先森 卧槽居然半年了。
        60343a0ad510:@iOS程序犭袁 这都半年了,还没有优化好吗?😂
        iOS程序犭袁:@口袋海贼王_ 很好的建议,后续会优化下
      • Airfei:在例子中,gcd中调用了cyl_reloaddata为什么还要调用一次系统的reloaddata方法呢!有什么考虑吗?
        iOS程序犭袁:@Airfei 多谢提醒,已经移除

      本文标题:一行代码完成“空TableView占位视图”管理

      本文链接:https://www.haomeiwen.com/subject/xcjvhttx.html