About

Collection View Layouts is a set of custom layouts for iOS which imitate general data grid approaches for mobile apps.

Layout types

Tags	Pinterest	500px	Instagram

Flipboard	Facebook	Flickr

Overview

7 popular layouts for iOS collection view
Tags and Flipboard layouts support left and right content align
500px has custom cells layout configuration
Three modes for Instagram layout (default grid mode, one preview cell, regular preview cell)
Each layout can be configured with content and cells paddings separately
Tests coverage more than 90%

Installation

CocoaPods

Collection View Layouts is available through CocoaPods. To install it, simply add the following lines (depends on your needs) to your Podfile:

pod 'collection-view-layouts/Core'
pod 'collection-view-layouts/TagsLayout'
pod 'collection-view-layouts/PinterestLayout'
pod 'collection-view-layouts/Px500Layout'
pod 'collection-view-layouts/InstagramLayout'
pod 'collection-view-layouts/FlipboardLayout'
pod 'collection-view-layouts/FacebookLayout'
pod 'collection-view-layouts/FlickrLayout'

Requirements

iOS: 11.0+
Swift: 5.0
CocoaPods: for iOS

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Usage

Configuration of custom layouts is pretty easy:

var layout: BaseLayout = TagsLayout()

layout.delegate = self
layout.delegate = ItemsPadding(horizontal: 10, vertical: 10)
layout.cellsPadding = ItemsPadding(horizontal: 8, vertical: 8)

collectionView.collectionViewLayout = layout
collectionView.reloadData()

Also, you have to implement LayoutDelegate protocol:

public protocol LayoutDelegate: class {
    func cellSize(indexPath: IndexPath) -> CGSize
}

func cellSize(indexPath: IndexPath) -> CGSize {
    return cellsSizes[indexPath.row]
}

License

Collection View Layouts is licensed under the Apache 2.0 license

RubyGarage is a leading software development and consulting company in Eastern Europe. Our main expertise includes Ruby and Ruby on Rails, but we successfuly employ other technologies to deliver the best results to our clients. Check out our portoflio for even more exciting works!

lephannam/collection-view-layouts