Presentables
So what is Presentables really? It is a really small library that should help you develop apps with table views a little bit faster than you would using the conventional methods. It also introduces binding of your data to the table views so any time you change your dataset, the table will update accordingly.
Checkout our examples for UICollectionView support!
Slack
Get help using and installing this product on our Slack, channel #help-presentables
Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Installation
Cocoapods
Presentables is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "Presentables"Carthage
Presentables is also available through Carthage. To install it, simply add the following line to your Cartfile:
github "manGoweb/Presentables"Usage
Create your cell like you would usually do
import UIKit
class MyTableViewCell: UITableViewCell { }
There are two ways to use presentables
Using data manager
Create a data manager
import Foundation
import Presentables
class TableDataManager: PresentableTableViewDataManager {
// MARK: Initialization
override init() {
super.init()
// Create a section
let section = PresentableSection()
// Create a cell with custom tap event
let presentable = Presentable<MyTableViewCell>.create({ (cell) in
cell.textLabel?.text = "First cell"
})
section.append(presentable)
// Now add your section to the data source
data.append(section)
}
}And lastly, bind your table view to your data manager
import UIKit
import Presentables
class ViewController: UITableViewController {
var manager: PresentableManager = TableDataManager()
// MARK: View lifecycle
override func viewDidLoad() {
super.viewDidLoad()
tableView.bind(withPresentableManager: &manager)
}
}or you could do a bit more ... here is a full spec data manager with all the functionality available
import Foundation
import Presentables
class TableDataManager: PresentableTableViewDataManager {
// MARK: Initialization
override init() {
super.init()
// Create a section in your table view
let section = PresentableSection()
// Add a header to it
let header = Presentable<TableViewHeader>.create { (header) in
header.titleLabel.text = "It works :)"
}
section.header = header
// Create a cell with custom tap event
let presentable = Presentable<TableViewCell1>.create({ (cell) in
cell.textLabel?.text = "First cell"
}).cellSelected {
print("First cell has been selected")
}
section.append(presentable)
// And add loads more different cells
for i in 2...51 {
let presentable = Presentable<TableViewCell2>.create({ (cell) in
cell.textLabel?.text = "Id: \((i))"
})
section.append(presentable)
}
// Now add your section to the data source
data.append(section)
// And finally create a global tap event for all cells
selectedCell = { info in
info.tableView.deselectRow(at: info.indexPath, animated: true)
print("Did select cell no. \((info.indexPath.row + 1))")
}
}
// MARK: Overriding table view delegate (optional)
func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
return 44
}
}Using designated view controller
If you are not into creating separate manager classes, you can use our pre-set view controller directly like this:
class ManagerTableViewController: PresentableTableViewController {
override func viewDidLoad() {
super.viewDidLoad()
// Create a section
let section = PresentableSection()
// Build a header
let header = Presentable<TableViewHeader>.create { (header) in
header.titleLabel.text = "It works yet again!"
}
section.header = header
// Add a cell!
let presentable = Presentable<TableViewCell2>.create({ (cell) in
cell.textLabel?.text = "Custom cell"
})
section.append(presentable)
data.append(section)
}
}I don't think it can get simpler than that ...
In case you'd like to implement your own version of a ManagerTableViewController (or any other class or view on that matter), you could use PresentableTableViewManageable like this:
open class MyTableViewController: UIViewController, PresentableTableViewManageable {
public var tableView = UITableView(frame: CGRect.zero, style: .plain)
public let presentableManager = PresentableTableViewDataManager()
public var data: PresentableSections {
get { return presentableManager.data }
set { presentableManager.data = newValue }
}
// MARK: View lifecycle
open override func viewDidLoad() {
super.viewDidLoad()
view.addSubview(tableView)
tableView.snp.makeConstraints { ... }
bind()
}
}Author
Ondrej Rafaj, [email protected]
License
Presentables is available under the MIT license. See the LICENSE file for more info.