A wrapper around UITableView which aims to facilitate working with tables.

• Onboarding
• Implementation Example
• Templates
• Snippets
• Requirements
• Installation

Onboarding

To start to use ImoTableView you need to understand the base concept, ImoTableView is composed of four classes.

1. ImoTableView is a subclass from UITableView and owns the role to manage with ImoTableViewSection's, add new sections, delete and update them.

2. ImoTableViewSection is a class that works with ImoTableViewSource's, add a new source, delete, update.

3. ImoTableViewSource is the base object for your new CellSource's this source contains base info about cell class, cell height, and other additional proprieties which you want to show in your cell, user name for example.

4. ImoTableViewCell is a view representation of properties you have stored in your source.

Implementation Example

Example of how quick and simple you can add and populate a tableView This is how swift ViewController.swift looks like

//Create a table and ad on some UIView
lettableView=ImoTableView(on: someUIView, insets:UIEdgeInsets(top:20, left:0, bottom:0, right:0))
//Create a new section
letsection=ImoTableViewSection()
//Create new cellSource
letactionCellSource=ActionCellSource(title:"Action")
//Add cellSource to section
section.add(actionCellSource)
//Add section to table View
tableView.add(section)
//Reload table
tableView.reloadData()

ActionCell.swift Contain an method swift open override func setUpWithSource(source:AnyObject) and this method is called every time ActionCell will be shown on screen and swift source:AnyObject is cell source with all properties you need to set up you cell.

openclassActionCell:ImoTableViewCell{
//UILabel from ActionCell.xib
@IBOutlet weak varactionTitle:UILabel!
//This method is called every time your cell will be displayed on screen
openoverridefunc setUpWithSource(source:AnyObject){
//Cast source to ActionCellSource
iflet source = source as?ActionCellSource{
//Set the label title
self.actionTitle.text = source.title
}}}

ActionCellSource.swift Contain an method swift open override func setUpWithSource(source:AnyObject) and this method is called every time ActionCell will be shown on screen and swift source:AnyObject is cell source with all properties you need to set up you cell.

openclassActionCellSource:ImoTableViewSource{publicvartitle:Stringinit(title:String){self.title = title
//Init source an specify cell class you will represent by this source
super.init(cellClass:"ActionCell")
//Set nib bundle if your cell is not in current project bundle
setNibBundle(with:Bundle.init(for:self.classForCoder))}}

Templates

The quick onboarding for use ImoTableView is to add ImoTableViewCell.xctemplate in your xcode templates, this template will create all you need to fast create an new Cell and CellSource for you

To add ImoTableViewCell.xctemplate.xctemplate in xcode you need to open File Templates folder, you can simply call this terminal command open /Applications/Xcode.app/Contents/Developer/Library/Xcode/Templates/File\ Templates/

After create an folder ImoTableView and copy in this folder ImoTableViewCell.xctemplate from Templates/ folder of this repo.

Snippets

ImoTableViewSection

//Create new section
letsection=ImoTableViewSection()
//Add CellSource
section.add(yourCellSource)
//Delete CellSource
section.delete(atIndex: yourCellIndex)
//Delete CellSource
section.delete(yourCellSource)
//Delete All
section.deleteAll()
//Set section header View
section.headerView = YourView
//Set section footer View
section.footerView = YourView

ImoTableView

//Create new table
lettable=ImoTableView()
//Add section
table.add(yourSection)
//Add sections
table.add(yourSections)
//Delete section at index
table.deleteSection(at: yourSectionIndex)
//Delete all sections
table.deleteAllSections()
//Did select source, after user touch up on cell
table.didSelectSource ={ source in
//Do something with source
}
//Did select cell at index path, after user touch up on cell
table.didSelectCellAtIndexPath ={ indexPath in
//Do something with source
}

Requirements

• iOS 8.0+
• Xcode 8.1+
• Swift 3.1+

Installation

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate ImoTableView into your Xcode project using Carthage, specify it in your Cartfile:

github "imodeveloperlab/ImoTableView" ~> 1.0

Run carthage update to build the framework and drag the built ImoTableView.framework into your Xcode project.

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.1.0+ is required to build ImoTableView 1.0.8+.

To integrate ImoTableView into your Xcode project using CocoaPods, specify it in your Podfile:

source'https://github.com/CocoaPods/Specs.git'platform:ios,'10.0'use_frameworks!target'<Your Target Name>'dopod'ImoTableView','~> 1.0.25'end

Then, run the following command:

$ pod install

Examples

Basic Example

//TABLE
lettable=ImoTableView(on:self.view)
//SECTION
letsection=ImoTableViewSection()
//FAKER
letfaker=Faker.init()letfirstName=TextCellSource(text:"First Name: \(faker.name.firstName())")
section.add(firstName)letlastName=TextCellSource(text:"Last Name: \(faker.name.lastName())")
section.add(lastName)letcompany=TextCellSource(text:"Company: \(faker.company.name())")
section.add(company)
table.add(section: section)

Basic Actions Example

overridefunc viewDidLoad(){
super.viewDidLoad()
//TABLE
lettable=ImoTableView(on:self.view)
//SECTION
letsection=ImoTableViewSection()
//FAKER
letfaker=Faker.init()
//1. First way
letappNameCell=ActionCellSource(title:"App name: \(faker.app.name())")
section.add(appNameCell, target:self, #selector(didSelectAppName))
//2. Second way
letappAuthorCell=ActionCellSource(title:"Author: \(faker.app.author())")
appAuthorCell.target =self
appAuthorCell.selector = #selector(didSelectAppAuthor)
section.add(appAuthorCell)
//3. Third way
letappVersion= faker.app.version()letappVersionCell=ActionCellSource(title:"App version: \(appVersion)")
appVersionCell.target =self
appVersionCell.object = appVersion asAnyObject
appVersionCell.selector = #selector(didSelectAppVersion)
section.add(appVersionCell)
table.add(section: section)}func didSelectAppVersion(sender:AnyObject){letversion= sender as!Stringshow(message:"Did select version \(version)")}func didSelectAppAuthor(){self.show(message:"Did select app author")}func didSelectAppName(){show(message:"Did select app name")}

Multiple Sections Example

//TABLE
lettable=ImoTableView(on:self.view)
//USER INFO SECTION
letuserInfoSection=ImoTableViewSection()
userInfoSection.headerTitle ="User info"letfirstName=TextCellSource(text:"First Name: \(faker.name.firstName())")
userInfoSection.add(firstName)letlastName=TextCellSource(text:"Last Name: \(faker.name.lastName())")
userInfoSection.add(lastName)
table.add(section: userInfoSection)
//BUSSINES INFO SECTION
letbussinesInfoSection=ImoTableViewSection()
bussinesInfoSection.headerTitle ="Bussines info"letcompany=TextCellSource(text:"Company: \(faker.company.name())")
bussinesInfoSection.add(company)letcardNumber=TextCellSource(text:"Credit Card: \(faker.business.creditCardNumber())")
bussinesInfoSection.add(cardNumber)letcardType=TextCellSource(text:"Type: \(faker.business.creditCardType())")
bussinesInfoSection.add(cardType)
table.add(section: bussinesInfoSection)
//Lorem section
letloremSection=ImoTableViewSection()
loremSection.headerTitle ="Lorem Ipsum"for_in0...20{lettext= faker.lorem.sentence()
loremSection.add(TextCellSource(text: text))}
table.add(section: loremSection)

Animate Add Cells Example

overridefunc viewDidLoad(){
super.viewDidLoad()
//HIDE THE KAYBOARD WHEN TAPPED ARROUND
self.hideKeyboardWhenTappedAround()
//TABLE
self.table =ImoTableView(on:self.view)
//ADD ONE CELL ACTION
letaddSource=ActionCellSource(title:"Add new Cell")
mainSection.add(addSource, target:self, #selector(addNewCell))
//ADD MULTIPLE CELL'S ACTION
letaddMultipleSource=ActionCellSource(title:"Add multiple Cells")
mainSection.add(addMultipleSource, target:self, #selector(addMultipleCells))
//HEADER TITLE
secondSection.headerTitle ="Cells"
//ADD SECTIONS TO TABLE
table.add(section: mainSection)
table.add(section: secondSection)}func addNewCell(){lettext= faker.lorem.sentence()letsource=TextCellSource(text: text)
table.add(source: source, in: secondSection, animated:true, animation:.top)}func addMultipleCells(){varsources:[TextCellSource]=[]for_in0...10{lettext= faker.lorem.sentence()
sources.append(TextCellSource(text: text))}
table.add(sources: sources, in: secondSection, animated:true, animation:.top)}

Animate Delete Cells Example

overridefunc viewDidLoad(){
super.viewDidLoad()self.hideKeyboardWhenTappedAround()self.table =ImoTableView(on:self.view)letdeleteFirstSource=ActionCellSource(title:"Delete first cell")
mainSection.add(deleteFirstSource, target:self, #selector(deleteFirst))letdeleteLastSource=ActionCellSource(title:"Delete last cell")
mainSection.add(deleteLastSource, target:self, #selector(deleteLast))letdeleteAllSource=ActionCellSource(title:"Delete all cells")
mainSection.add(deleteAllSource, target:self, #selector(deleteAll))
secondSection.headerTitle ="Cells"addMultipleCells()
table.add(section: mainSection)
table.add(section: secondSection)}func addMultipleCells(){varsources:[TextCellSource]=[]for_in0...5{lettext= faker.lorem.sentence()
sources.append(TextCellSource(text: text))}
secondSection.add(sources: sources)}func deleteFirst(){iflet source = secondSection.firstSource(){
table.delete(source: source, in: secondSection, animated:true, animation:.left)}}func deleteLast(){iflet source = secondSection.lastSource(){
table.delete(source: source, in: secondSection, animated:true, animation:.right)}}func deleteAll(){letallSources= secondSection.allSources()
table.delete(sources: allSources, in: secondSection, animated:true, animation:.top)}

Animate Delete Cells Example

self.hideKeyboardWhenTappedAround()lettable=ImoTableView(on:self.view, insets:UIEdgeInsets(top:0, left:0, bottom:0, right:0))
table.tableView.contentInset =UIEdgeInsets(top:100, left:0, bottom:60, right:0)
table.tableView.scrollIndicatorInsets =UIEdgeInsets(top:100, left:0, bottom:60, right:0)
table.adjustContentInsetsForKeyboard(true)letsection=ImoTableViewSection()for_in0...5{lettextField=TextFieldCellSource(staticCellWithTableView: table)
section.add(textField)}for_in0...20{lettext= faker.lorem.sentence()
section.add(TextCellSource(text:text))}
table.add(section: section)