Skip to content

rubygarage/collection-view-layouts

Repository files navigation

Build Status codecov

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]
}

Author

Sergey Afanasiev

Getting Help

sergey.afanasiev@rubygarage.org

License

Collection View Layouts is licensed under the Apache 2.0 license


RubyGarage Logo

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!