Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MostafaTaghipour/iOSEasyList
A data-driven UICollectionView and UITableView framework for building fast and flexible lists
https://github.com/MostafaTaghipour/iOSEasyList
animation datasource diffable empty-view endless endless-scroll expandable filterable infinite-scroll loading-footer multiple-data-type pagination sectioned swift uicollectionview uicollectionviewlayout uitableview
Last synced: 23 days ago
JSON representation
A data-driven UICollectionView and UITableView framework for building fast and flexible lists
- Host: GitHub
- URL: https://github.com/MostafaTaghipour/iOSEasyList
- Owner: MostafaTaghipour
- License: mit
- Created: 2018-01-27T18:22:48.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-28T17:41:21.000Z (over 5 years ago)
- Last Synced: 2024-11-07T14:42:33.313Z (about 1 month ago)
- Topics: animation, datasource, diffable, empty-view, endless, endless-scroll, expandable, filterable, infinite-scroll, loading-footer, multiple-data-type, pagination, sectioned, swift, uicollectionview, uicollectionviewlayout, uitableview
- Language: Swift
- Homepage:
- Size: 47.9 MB
- Stars: 32
- Watchers: 4
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iOSEasyList
[](https://travis-ci.org/[email protected]/iOSEasyList)
[](http://cocoapods.org/pods/iOSEasyList)
[](http://cocoapods.org/pods/iOSEasyList)
[](http://cocoapods.org/pods/iOSEasyList)
## [Android version is here](https://github.com/MostafaTaghipour/AndroidEasyList)
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
## Requirements
- Swift 4
- iOS 8+
## Installation
iOSEasyList is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'iOSEasyList'
```
## Usage
1. Define your model
```swift
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
}
}
```
2. Define `TableViewAdapter` in ViewController
```swift
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
}()
```
3. Set Data
```swift
override func viewDidLoad() {
super.viewDidLoad()
adapter.setData(newData: items, animated: true)
}
```
4. 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
- [AlignedCollectionViewFlowLayout](https://github.com/mischa-hildebrand/AlignedCollectionViewFlowLayout)
## Author
Mostafa Taghipour, [email protected]
## License
iOSEasyList is available under the MIT license. See the LICENSE file for more info.