iOS 一行代码设置UITableView占位view(swif

开发场景:

iOS开发中常见的这么一种情形,UITableView显示网络请求的数据列表,在无网络或者服务器返回内容为空时,需要显示占位view,以提醒用户当前无数据.

常规思路

通常我们是在网络请求结束后,通过判断返回数据 dataList.count == 0,来设置占位view来替换或者覆盖tableView.这么做需要逐个列表控制器处理,代码分散不易集中管理.

我的方案

这里提供一种简便快捷的方案.可以满足一般性的需求.

• 思路

  1. 通过判断 UITableViewDataSource数据源方法 numberOfSection 和 numberOfRowsInSection来判断是否有cell要被加载.
  2. 当有cell时,设置tableView的tableFooterView = UIView(),不显示footer;当cell为空时,设置tableFooterView = CustomPlaceHolderView()

• 实现

  1. 协议+扩展默认实现 以减少代码量和代码耦合
  2. 用户主动调度设置占位view函数,灵活简便

  gist code in github

protocol TableEmptable {

    /// 列表是否为空
    var isEmptyData: Bool { get }
    /// 提供占位view,该view将占据tableView的tableFooterView
    var placeHolderView: UIView { get }
    /// 建议在reloadData前,调用该方法
    func setPlaceholderIfNeed()
}

extension TableEmptable where Self : UITableViewController {

    var isEmptyData: Bool  {
        let sectionCount: Int = numberOfSections(in: self.tableView)
        if sectionCount == 0 { return true }
        for section in 0 ..< sectionCount {
            if tableView(tableView, numberOfRowsInSection: section) != 0 { return false }
        }
        return true
    }
    
    var placeHolderView: UIView {
        let imgView = UIImageView(frame: CGRect(x: 0, y: 0, width: kScreenWidth, height: 375))
        imgView.image = UIImage(named: "ooxx")
        return imgView
    }
    
    func setPlaceholderIfNeed() {
        if self.isEmptyData {
            self.tableView.tableFooterView = placeHolderView
        } else {
            self.tableView.tableFooterView = UIView()
        }
    }
}

如何使用

1. 遵守TableEmptable协议(MyTableViewController : TableEmptable)
2. 在reloadData前调用setPlaceHolderIfNeed

(当然别忘了你的placeHolderView需要自己定义)

测试代码

import UIKit

fileprivate let cellID = "identifier_KHCardController"

class TestController: UITableViewController , TableEmptable {
    
    var list : [String] = Array(repeating: "ooxx", count: Int(arc4random_uniform(2)))
    
    override func viewDidLoad() {
        super.viewDidLoad()

        title = "测试"
        view.backgroundColor = UIColor.white
        
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: cellID)
        
        navigationItem.rightBarButtonItem = UIBarButtonItem(barButtonSystemItem: UIBarButtonSystemItem.refresh, target: self, action: #selector(reload))
        
        /// 设置占位图
        setPlaceholderIfNeed()
    }
}

extension TestController {
    
    override func numberOfSections(in tableView: UITableView) -> Int {
        return 5
    }
    
    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return list.count
    }
    
    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: cellID, for: indexPath)
        cell.textLabel?.text = list[indexPath.row] + "\(indexPath)"
        return cell
    }
}

extension TestController {

    @objc fileprivate func reload() {
        list = Array(repeating: "ooxx", count: Int(arc4random_uniform(2)))
        
        /// 设置占位图
        setPlaceholderIfNeed()
        
        self.tableView.reloadData()
    }
}