目前市面上的主流 app 毫无疑问的 UI 都是列表,即UITableview 或者 UICollectionView,由于用得多,写得也多,如果每次实现一个列表都要重复去创建 tableview,然后重复实现数据源和代理,还要处理多页加载的问题,WDF 你不嫌累我看着都累,于是,封装一个列表属性的控件非常有必要,在我构思中,我的想法是:其实我们每次做的刷新列表都是一样的,不一样的只是 cell 不一样,因此,最好的方式就是只需要注册号自己的 cell,把数据源传给 DataSource 其他事都可以不用管了。而且,它必须支持自动计算分页,当我先上刷新的时候会自动计算页数,数据请求后会自动添加上去,下拉刷新时会自动请求第一页的数据重新赋值给 DataSource,这样一来思路就很清晰了。
先看看最终设置代码,只需要继承基类BaseRefreshTableVC,设置好 cell 类型,然后在refreshData方法里面把网络请求下来的数据传给闭包即可:
override func viewDidLoad() {
super.viewDidLoad()
setup(estimatedRowHeight: 100, cell: TestTableViewCell.self)
}
override func refreshData(completionHandler: @escaping ([Any]) -> ()) {
//网络请求获取数据,pageIndex是基类自动计算好的页数,直接传给网络请求参数即可
var data = [""]
for item in 0...pageIndex * 10{
data.append("\(item)")
}
completionHandler(data)
}
接下来说实现思路。
首先新建一个基类 BaseRefreshTableVC,里面把该做的初始化 tableview 做好:
tableView.delegate = self;
tableView.dataSource = self;
tableView.separatorStyle = UITableViewCell.SeparatorStyle.none
tableView.estimatedRowHeight = 60;
tableView.separatorInset = UIEdgeInsets()
tableView.separatorStyle = .singleLine
tableView.tableFooterView = UIView()
view.addSubview(tableView)
tableView.snp.makeConstraints { (make) in
make.edges.equalToSuperview()
}
接着设置好头部刷新和尾部刷新,这里我用得 MJ 的 MJRefresh:
tableView.mj_header = MJRefreshNormalHeader.init(refreshingBlock: {
self.tableView.mj_header.endRefreshing()
self.tableView.mj_footer.endRefreshing()
self.pageIndex = 0;
self.refreshData(completionHandler: { (obj) in
self.dataSource = obj
self.tableView.reloadData()
})
})
tableView.mj_footer = MJRefreshAutoFooter.init(refreshingBlock: {
self.tableView.mj_header.endRefreshing()
self.pageIndex += 1
self.refreshData(completionHandler: { (obj) in
self.dataSource.append(contentsOf: obj)
self.tableView.reloadData()
})
})
大部分场景都是进入列表视图就是自动刷新请求数据,所以在基类加上刷新:
tableView.mj_header.beginRefreshing()
好了,基础代码实现后,接下来看看基类暴露的 api:
public let tableView = UITableView()
public var dataSource = [Any]()
public var pageIndex = 0
public func refreshData(completionHandler: @escaping (_ response:[Any]) ->() ){}
1.暴露 tableview 是为了将来的可扩展性,相信项目中不可能只是单纯的列表,往往还有什么 header、footer,需要设置的时候可以方便设置。
2.dataSurce,没什么可说的,比如需要在 didselected 代理方法做事情就可以用到datasouce 内容了。
- pageIndex为每次刷新的页数,默认第一页为0,如果你们项目默认是1就自己改成1就可以了。
4.最后refreshData方法是提供给子类实现的,子类重写refreshData实现请求数据后吧数据传给completionHandler,基类收到数据就会自动 reloadData,并且 pageIndex 自动➕1
最后,说一下 tableviewCell,我也是建议用个 BaseTableViewCell,定义三个公共方法:
setupViews、setupLayout、configeWithModel分别实现对 UI控件的初始化创建、约束、和赋值。同理,我也在 baseVC、baseView 中定义了这几个通用的方法,以后创建 UI 直接继承基类,子类实现 setupViews、setupLayout就可以完成子控件初始化,再也不用一个控制器一种初始化控件方法名,有利于代码规范整齐,详细看 demo 就可以了。
另外我也写了个简单的分类用来快速创建 UILabel、UIImageView、UIButton
例:
extension UIButton{
public class func cjw_buttonTitle(whit title:String,fontSize:Int,textColor:Int) ->(UIButton){
let btn = UIButton()
btn .setTitle(title, for: .normal)
btn.titleLabel?.font = UIFont.systemFont(ofSize: CGFloat(fontSize))
btn.setTitleColor(UIColor.jk_color(withHex: UInt32(textColor)), for: .normal)
return btn
}
public class func cjw_buttonImage(whit image:String) ->(UIButton){
let btn = UIButton()
btn.setImage(UIImage(named: image), for: .normal)
return btn
}
}
喜欢的可以点个 star,你举手之劳我会开心死的,哈哈。
github 地址:(持续更新)
https://github.com/JW-chenjingwei/BaseObject_Swift