Skip to content

A data-driven UICollectionView and UITableView framework for building fast and flexible lists

License

Notifications You must be signed in to change notification settings

MostafaTaghipour/iOSEasyList

Repository files navigation

iOSEasyList

CI Status Version License Platform

Framework to simplify the setup and configuration of UITableView and UICollectionView data sources and cells. It allows a type-safe setup of (UITableView,UICollectionView) DataSource and Delegate. DataSource also provides out-of-the-box diffing and animated deletions, inserts, moves and changes.

Everything you need to implement your own lists:

  • Easy to use UITableView and UICollectionView
  • No more calling reloadData
  • Diffable
  • Configurable animations
  • Sectioned
  • Pagination
  • Collapsible
  • Loading footer
  • Various UICollectionView layouts
  • Empty View
  • Filterable
  • Multiple data type

animation expandable filtering message layout pagination sectioned

Requirements

  • Swift 4
  • iOS 8+

Installation

iOSEasyList is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'iOSEasyList'

Usage

  1. Define your model
struct Movie{
    let id : String
    let title : String
}

//optional: If you want to use Diffable capabilities (e.g. automatic animations like delete, insert, move , reload)
//           inherit 'Diffable' ptotocol
extension Movie:Diffable{
    var diffIdentifier: String {
        return id
    }

    //optional: this function need for automatic reload
    func isEqual(to object: Any) -> Bool {
        guard let to = object as? Model else { return false }

        return self.id==to.id &&
               self.title==to.title
    }
}
  1. Define TableViewAdapter in ViewController
lazy var adapter: TableViewAdapter = { [unowned self] in
    let adapter=TableViewAdapter(tableView: tableView) { (tv, ip, item) -> (UITableViewCell) in
        let cell = tv.dequeueReusableCell(withIdentifier: MovieCell.reuseIdentifier, for: ip) as! MovieCell
        cell.data = item as? Movie
        return cell
    }
    
    //optional
    adapter.animationConfig = AnimationConfig(reload: .fade, insert: .top, delete: .bottom)
    
    return adapter
}()
  1. Set Data
override func viewDidLoad() {
    super.viewDidLoad()
    adapter.setData(newData: items, animated: true)
}
  1. That's it, for more samples please see example project

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Thanks for

Author

Mostafa Taghipour, mostafa@taghipour.me

License

iOSEasyList is available under the MIT license. See the LICENSE file for more info.