ESPullToRefresh
ESPullToRefresh是一个非常易于开发者使用的下拉刷新和加载更多组件。通过一个UIScrollView的扩展,可以轻松为UIScrollView的所有子类添加下拉刷新功能。 如果你想定制组件的UI样式,只要实现指定的协议方法即可。
如何安装
使用CocoaPods
pod "ESPullToRefresh"
手动安装
git clone https://github.com/eggswift/pull-to-refresh.git
open ESPullToRefresh
开始使用
使用默认样式 效果如下:
![](https://i-blog.csdnimg.cn/blog_migrate/98c7c0f44c58d0b9e1287a70bd76b6af.webp?x-image-process=image/format,png)
example_default.gif
设置默认下拉刷新组件
self.tableView.es_addPullToRefresh {
[weak self] in
/// 在这里做刷新相关事件
/// ...
/// 如果你的刷新事件成功,设置completion自动重置footer的状态
self?.tableView.es_stopPullToRefresh(completion: true)
/// 设置ignoreFooter来处理不需要显示footer的情况
self?.tableView.es_stopPullToRefresh(completion: true, ignoreFooter: false)
})
}
设置默认加载更多组件
self.tableView.es_addInfiniteScrolling {
[weak self] in
/// 在这里做加载更多相关事件
/// ...
/// 如果你的加载更多事件成功,调用es_stopLoadingMore()重置footer状态
self?.tableView.es_stopLoadingMore()
/// 通过es_noticeNoMoreData()设置footer暂无数据状态
self?.tableView.es_noticeNoMoreData()
})
}
使用自定义样式 效果如下:
![](https://i-blog.csdnimg.cn/blog_migrate/49a53e31b02fd910d3ac0cf61d7e9334.webp?x-image-process=image/format,png)
example_meituan.gif
注: 加载动画资源来自美团 iOS app。
![](https://i-blog.csdnimg.cn/blog_migrate/ce331b5b85c370e2ebc9184cc3092b9a.webp?x-image-process=image/format,png)
example_wechat.gif
ESPullToRefresh
通过ESRefreshProtocol
和ESRefreshAnimatorProtocol
来约束刷新组件的使用,自定义的组件必须遵守这两个协议,并实现协议中的方法。
设置自定义下拉刷新组件
func es_addPullToRefresh(animator animator: protocol<ESRefreshProtocol, ESRefreshAnimatorProtocol>,
handler: ESRefreshHandler)
设置自定义加载更多组件
func es_addInfiniteScrolling(animator animator: protocol<ESRefreshProtocol, ESRefreshAnimatorProtocol>,
handler: ESRefreshHandler)
移除方法
func es_removeRefreshHeader()
func es_removeRefreshFooter()