https://github.com/AfrozZaheer/AZTableViewController
Elegant and easy way to integrate pagination with dummy views
https://github.com/AfrozZaheer/AZTableViewController
Last synced: 3 months ago
JSON representation
Elegant and easy way to integrate pagination with dummy views
- Host: GitHub
- URL: https://github.com/AfrozZaheer/AZTableViewController
- Owner: AfrozZaheer
- License: mit
- Created: 2017-07-31T09:16:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-01-18T10:52:26.000Z (almost 8 years ago)
- Last Synced: 2024-11-20T21:56:55.039Z (12 months ago)
- Language: Swift
- Homepage: https://www.cocoacontrols.com/controls/az-tableview
- Size: 60.5 KB
- Stars: 74
- Watchers: 5
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - AZTableViewController - Elegant and easy way to integrate pagination with dummy views. (UI / Table View / Collection View)
- awesome-swift - AZTableViewController - Elegant and easy way to integrate pagination with placeholder views. (Libs / UI)
- awesome-swift - AZTableViewController - Elegant and easy way to integrate pagination with placeholder views. (Libs / UI)
- awesome-ios-star - AZTableViewController - Elegant and easy way to integrate pagination with dummy views. (UI / Table View / Collection View)
- fucking-awesome-swift - AZTableViewController - Elegant and easy way to integrate pagination with placeholder views. (Libs / UI)
- awesome-swift - AZTableViewController - Elegant and easy way to integrate pagination with dummy views ` 📝 3 years ago` (UI [🔝](#readme))
README
# AZTableView Controller
[](https://github.com/sindresorhus/awesome)
[](https://img.shields.io/badge/swift-3.0-orange.svg?style=flat.svg)
[](https://img.shields.io/badge/support-CocoaPods-red.svg?style=flat.svg)
[](https://cocoapods.org/pods/AZTableView)
[](https://img.shields.io/badge/License-MIT-brightgreen.svg?style=flat.svg)
[](https://cocoapods.org/pods/AZTableView)
## Features
* Automatic pagination handling
* No more awkward empty TableView screen
* AZ TableView controller give you advantage to connect your (Loading, no result, error ) views via Interface builder
## New in version 0.0.2
* You can now add your custom xib as dummy views (loading, error, no result)
* You can add xib based next page loading cell also
## Installation
### CocoaPods
[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:
```bash
$ gem install cocoapods
```
To integrate AZTableViewController into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
target '' do
pod 'AZTableView'
end
```
Then, run the following command:
```bash
$ pod install
```
## Usage
#### Step 1
* Extend your view controller from AZTableVIewController
```swift
class ViewController: AZTableViewController {
var lastIndex = 0
var results = [String]()
override func viewDidLoad() {
super.viewDidLoad()
self.fetchData()
}
override func viewDidAppear(_ animated: Bool) {
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
```
#### Step 2
* Set the next page loading cell outlet as given below,
* To load views from custom .xib files
```swift
class ViewController: AZTableViewController {
override func viewDidLoad() {
self.loadLoadingView(nibName: "your nib name") // if bundle is nil
self.loadErrorView(nibName: "your nib name", bundle: yourBundle) // if custom bundle
super.viewDidLoad()
self.fetchData()
}
}
```
* If your xibs are in main bundle than use
```swift
self.loadLoadingView(nibName: "your nib name") // if bundle is nil
```
Else use
```swift
self.loadLoadingView(nibName: "your nib name", bundle: yourBundle)
```
#### Step 3
* Confirm your controller to UITableViewDelegate and UITableViewDataSource
* And override AZtabeView cellForRow function.
```swift
extension ViewController : UITableViewDataSource, UITableViewDelegate {
override func AZtableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
if let cell = tableView.dequeueReusableCell(withIdentifier: "Cell")
{
cell.textLabel?.text = results[indexPath.row]
return cell
}
return UITableViewCell()
}
override func AZtableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return results.count
}
}
```
#### Step 4
* Override two more functions "fetchData" and "fetchNextData"
```swift
//MARK: - API Call
extension ViewController {
override func fetchData() {
super.fetchData()
FakeService.getData { (error, results) in
if let resu = results {
self.results.removeAll()
self.results.append(contentsOf: resu)
self.didfetchData(resultCount: resu.count, haveMoreData: true)
}
else if let error = error {
self.errorDidOccured(error: error)
}
}
}
override func fetchNextData() {
super.fetchNextData()
FakeService.getData (offset: results.count) { (error, results) in
if let resu = results {
self.results.append(contentsOf: resu)
if self.results.count < 45 { // you probably get next page exist from service.
self.didfetchData(resultCount: resu.count, haveMoreData: true)
}
else {
self.didfetchData(resultCount: resu.count, haveMoreData: false)
}
}
else if let error = error {
self.errorDidOccured(error: error)
}
}
}
}
```
#### Done
Thats it, you successfully integrate AZTableViewController
## License
AZTableView is available under the MIT license. See the LICENSE file for more info.
## Author
**Afroz Zaheer** - (https://github.com/AfrozZaheer)