Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ahmedalmasri/snadapter
iOS swift tableview and collectionView Adapter
https://github.com/ahmedalmasri/snadapter
adapter associated associated-type collectionview collectionviewcell generic tableview tableviewcell
Last synced: 1 day ago
JSON representation
iOS swift tableview and collectionView Adapter
- Host: GitHub
- URL: https://github.com/ahmedalmasri/snadapter
- Owner: ahmedAlmasri
- License: mit
- Created: 2019-04-20T18:55:09.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-04-09T20:31:26.000Z (over 4 years ago)
- Last Synced: 2024-11-10T04:18:05.932Z (8 days ago)
- Topics: adapter, associated, associated-type, collectionview, collectionviewcell, generic, tableview, tableviewcell
- Language: Swift
- Homepage:
- Size: 91.8 KB
- Stars: 39
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A declarative type-safe framework for building fast and flexible lists with TableView & CollectionView, No more delegates and datasource. Just a fully type-safe declarative content approach
[](https://travis-ci.org/ahmedAlmasri/SNAdapter)
[](https://cocoapods.org/pods/SNAdapter)
[](https://cocoapods.org/pods/SNAdapter)
[](https://cocoapods.org/pods/SNAdapter)
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Using
**Step 1**: Import the `SNAdapter` module in swift.
```swift
import SNAdapter
```
# TableView
**Step 1**: declare a new class or struct conform from `SNCellableModel`
```swift
struct MyModel: SNCellableModel {
let title: String
}
```
**Step 2**: declare a new `UITableViewCell` conform from `SNCellable`
```swift
class MyCell: UITableViewCell, SNCellable {
func configure(_ object: SNCellableModel?) {
guard let myModel = object as? MyModel else { return }
self.textLabel?.text = myModel.title
}
}
```
**Step 3**: Take a reference to `SNTableViewSection` and `SNTableViewAdapter` into your controller.
```swift
private var mySection: SNTableViewSection!
private var myAdapter: SNTableViewAdapter!
```
**Step 4**: Initialize the `SNTableViewSection` and `SNTableViewAdapter` in your viewDidLoad .
```swift
override func viewDidLoad() {
super.viewDidLoad()
///....
// MARK: - call setup section
setupMySection()
///...
}
private func setupMySection() {
mySection = SNTableViewSection(items: getMyListData())
myAdapter = SNTableViewAdapter(sections: [mySection])
myTableView.setAdapter(myAdapter)
}
private func getMyListData() -> [MyModel] {
return [MyModel(title: "Item 1"), MyModel(title: "Item 2")]
}
```
## More Example
* [Pagination (Load More) Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/TableView/Paging)
* [Sections Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/TableView/Sections)
* [Actions Delegate Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/TableView/ActionDelegate)
# CollectionView
**Step 1**: declare new `UICollectionViewCell` inherent form `SNCellable`
```swift
class MyCell: UICollectionViewCell, SNCellable {
@IBOutlet weak var titleLabel: UILabel!
func configure(_ object: SNCellableModel?) {
guard let myModel = object as? MyModel else { return }
titleLabel.text = myModel.title
}
}
```
**Step 2**: Take a reference to `SNCollectionViewSection` and `SNCollectionViewAdapter` into your controller.
```swift
private var mySection: SNCollectionViewSection!
private var myAdapter: SNCollectionViewAdapter!
```
**Step 3**: Initialize the `SNCollectionViewSection` and `SNCollectionViewAdapter` in your viewDidLoad .
```swift
override func viewDidLoad() {
super.viewDidLoad()
///....
// MARK: - call setup section
setupMySection()
///...
}
private func setupMySection() {
mySection = SNCollectionViewSection(items: getMyListData())
myAdapter = SNCollectionViewAdapter(sections: [mySection])
myCollectionView.setAdapter(myAdapter)
}
private func getMyListData() -> [MyModel] {
return [MyModel(title: "Item 1"), MyModel(title: "Item 2")]
}
```
## More Example
* [Pagination (Load More) Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/TableView/Paging)
* [Header Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/CollectionView/Header)
* [Actions Delegate Example](https://github.com/ahmedAlmasri/SNAdapter/blob/master/Example/SNAdapter/TableView/ActionDelegate)
## Requirements
* Swift 4.2+
* Xcode 10.0+
* iOS 11.0+
## Installation
SNAdapter is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'SNAdapter'
```
## Author
ahmedAlmasri, [email protected]
## License
SNAdapter is available under the MIT license. See the LICENSE file for more info.