Latest 0.1.2
Homepage https://github.com/AfrozZaheer/AZCollectionViewController
License MIT
Platforms ios 9.3
Authors

AZCollectionView Controller

Awesome
Swift version
Support Dependecy Manager
Version
License
Platform


Features

  • Automatic pagination handling
  • No more awkward empty CollectionView screen
  • AZ CollectionVIew controller give you advantage to connect your (Loading, no result, error ) views via Interface builder
  • You can also add your custom xib as dummy views (loading, error, no result)

Installation

CocoaPods

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

$ gem install cocoapods

To integrate AZ CollectionVIew controller 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>' do
pod 'AZCollectionViewController'
end

Then, run the following command:

$ pod install

Usage

Step 1

  • Extend your view controller from AZCollectionViewController

class ViewController: AZCollectionViewController {

var lastIndex = 0
var results = [String]()

override func viewDidLoad() {

    nextLoadingCellNibName = "LoadingCollectionViewCell"
    nextLoadingCellIdentifier = "LoadingCollectionViewCell"
    loadNextPageLoaderCell(nibName: nextLoadingCellNibName, cellIdentifier: nextLoadingCellIdentifier) // Only if you want personal NextPage loading cell

    super.viewDidLoad()
    self.fetchData()

}

override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
}

}


#### Step 2

* Same as AZTableVIewController
* Set the loading views outlet as given below
* Connect collectionView outlet as well

![Alt text](http://i.imgur.com/SWYNa2W.png "AZTableView-step2")

![Alt text](http://i.imgur.com/Zi9RKJ2.png "AZTableView-step2")

* To load views from custom .xib files 

```swift 

class ViewController: AZCollectionViewController {
    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
    self.loadLoadingView(nibName: "your nib name") // if bundle is nil

    Else use

    self.loadLoadingView(nibName: "your nib name", bundle: yourBundle)

Step 3

  • And override AZCollectionView cellForRow function.
extension ViewController {

    override func AZCollectionView(_ collectionView: UICollectionView, cellForRowAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "cell", for: indexPath) as! TestCollectionViewCell

        cell.feedImage.image = UIImage(named: self.results[indexPath.row])

        return cell
    }

    override func AZCollectionView(_ collectionView: UICollectionView, heightForRowAt indexPath: IndexPath) -> CGSize {

        return CGSize(width: (collectionView.frame.size.width / 3) - 6, height: (collectionView.frame.size.width / 3) - 4)

    }
}

Step 4

  • Override two more functions "fetchData" and "fetchNextData"
//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 AZCollectionViewController

License

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

Author

Afroz Zaheer – (https://github.com/AfrozZaheer)

Latest podspec

{
    "name": "AZCollectionViewController",
    "version": "0.1.2",
    "summary": "Automatic pagination handling and loading views",
    "description": "Automatic pagination handlingnNo more awkward empty CollectionView. can make Instagram like Discover within minutes.",
    "homepage": "https://github.com/AfrozZaheer/AZCollectionViewController",
    "platforms": {
        "ios": "9.3"
    },
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "AfrozZaheer": "[email protected]"
    },
    "source": {
        "git": "https://github.com/AfrozZaheer/AZCollectionViewController.git"
    },
    "resource_bundles": {
        "AZCollectionViewElements": [
            "Source/**/*.{xib}"
        ]
    },
    "source_files": "Source/**/*.{swift}",
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This