Custom UITableView container class that supports pull-to-refresh, load-more, initial load, and empty states. This library aims to be a drop in replacement for UITableView
. Swift port of SKStatefulTableViewController.
This is a work in progress. A lot of things may break as of the moment.
Initial loading:
Pull-to-refresh:
Load more:
Initial load error:
Load more error:
Currently, you can only assign the delegates and data source through code.
tableView.dataSource = self // Confofrms to UITableViewDataSource
tableView.delegate = self // Conforms to UITableViewDelegate
tableView.statefulDelegate = self // Conforms to StatefulTableDelegate
For initial loading, pull-to-refresh, and load more, you have to implement the following statefulDelegate methods:
// Initial Load
func statefulTable(_ tableView: StatefulTableView,
initialLoadCompletion completion: @escaping InitialLoadCompletion)
// Pull-to-Refresh
func statefulTable(_ tableView: StatefulTableView,
pullToRefreshCompletion completion: @escaping InitialLoadCompletion)
// Loading More
func statefulTable(_ tableView: StatefulTableView,
loadMoreCompletion completion: @escaping LoadMoreCompletion)
//////////////////////////////
// RENAMED from the ff:
// MARK: Unavailable – Renamed as declared above...
func statefulTableViewWillBeginInitialLoad(tvc: StatefulTableView,
handler: @escaping InitialLoadCompletionHandler)
func statefulTableViewWillBeginLoadingFromRefresh(tvc: StatefulTableView,
handler: @escaping InitialLoadCompletionHandler)
func statefulTableViewWillBeginLoadingMore(tvc: StatefulTableView,
handler: @escaping LoadMoreCompletionHandler)
To show custom views, return them through the following statefulDelegate methods –
or you can return a UIView subclass of your own, or return nil
otherwise.
func statefulTable(_ tableView: StatefulTableView,
initialLoadWithError errorOrNil: NSError?,
errorView: InitialLoadErrorView) -> UIView?
func statefulTable(_ tableView: StatefulTableView,
initialLoadWithError errorOrNil: NSError?,
errorView: InitialLoadErrorView) -> UIView?
func statefulTable(_ tableView: StatefulTableView,
loadMoreWithError: NSError?,
errorView: UIView) -> UIView?
//////////////////////////////
// RENAMED from the ff:
// MARK: Unavailable – Renamed as declared above...
@objc optional func statefulTableViewViewForInitialLoad(tvc: StatefulTableView) -> UIView?
@objc optional func statefulTableViewInitialErrorView(tvc: StatefulTableView,
forInitialLoadError: NSError?) -> UIView?
@objc optional func statefulTableViewLoadMoreErrorView(tvc: StatefulTableView,
forLoadMoreError: NSError?) -> UIView?
Add this to your Podfile.
pod 'StatefulTableView', '0.1.0'
Pull Requests for fixes and additional functionalities are always welcome. Contributions to the project's roadmap are also appreciated.
- Swift 4