Add infinite scrolling to collection view.
This is a basic implementation to add infinite scrolling behaviour in a
Usage is pretty simple.
InfiniteScrollingBehaviour has one designated initializer.
init(withCollectionView collectionView: UICollectionView, andData dataSet: [InfiniteScollingData], delegate: InfiniteScrollingBehaviourDelegate, configuration: CollectionViewConfiguration = .default)
InfiniteScrollingData is a protocol which your modal needs to conform to. Right now its an empty protocol, but for scalability purpose, I felt like adding data set as collection of custom protocol instead of
CollectionViewConfiguration can be used to tweak some behaviour of the infinite scrolling.
You neeed to provide
scrollingDirection. Based on these two properties, boundary elements are added as well as size for cell is calculated.
InfiniteScrollingBehaviour has a
CollectionViewConfiguration with layout value
LayoutType has two case:
case fixedSize(sizeValue: CGFloat, lineSpacing: CGFloat): If you need fixed size (if horizontal scrolling,
sizeValuevalue will be cell's width, whereas in vertical scrolling, it will be cell's height. )
case numberOfCellOnScreen(Double): If you dont care about size and you need fixed number of elements on screen irrespective of screen size.
Incase you need to have infinite scrolling with pagination, enable pagination in the collectionView and pass in
Note: Currently does not support custom flow layout and unequal cell sizes.
The delegate has two methods.
func configuredCell(forItemAtIndexPath indexPath: IndexPath, originalIndex: Int, andData data: InfiniteScollingData, forInfiniteScrollingBehaviour behaviour: InfiniteScrollingBehaviour) -> UICollectionViewCell func didSelectItem(atIndexPath indexPath: IndexPath, originalIndex: Int, andData data: InfiniteScollingData, inInfiniteScrollingBehaviour behaviour: InfiniteScrollingBehaviour) -> Void
First is a required method. Implementation needs to provide a configured
UICollectionViewCell based on following parameters.
- indexPath: Actual indexpath in the collectionView.
- originalIndex: Index in the original data set.
InfiniteScollingDatawhich will be used to configure your cell.
Note: If the number of elements in the data set is smaller than the
maxNumberOfCellsOnScreen, than it automatically adjusts boundary to repeat the same elements on screen.
To run the example project, clone the repo, and run
pod install from the Example directory first.
- Minimum iOS version: 9.0
- Swift: 3.0
- Xcode 8
InfiniteScrolling is available through CocoaPods. To install it, simply add the following line to your Podfile:
InfiniteScrolling is available under the MIT license. See the LICENSE file for more info.