MultiStateTableViewController

Goal

MultiStateTableViewController implements a table view that can simply be transformed into a loading state or an empty result state. This controller is useful when you are calling REST API to display data in a table view. The view should be in the loading state when loading the data from REST API. If somehow REST API returns no results or fails to load, a proper error message can be displayed to users through the empty state.

Usage

You can simply copy MultiStateTableViewController.swift file into your project and create your own view controller that is a sub-class of MultiStateTableViewController:

class YourMultiStateTableViewController : MultiStateTableViewController {
  // Your code ...
}

In order to show the loading state, just call showLoading() method from your view controller. For example. you can turn the view into the loading state when you are calling REST API to get the data for your table view:

self.showLoading()
// Call API to get the data for the table view ...

When the API has returned the data, you can reload the table data and call showTable() to hide the loading state:

// API returned results ...
self.mainTableView?.reloadData()
self.showTable()

If your API somehow returned nothing for your request, you can use showMessage(message: String) method to tell user what happened:

// API returned nothing ...
self.showMessage("Your table is empty")