Skip to content

starlight173/collection-view-layouts

 
 

Repository files navigation

Build Status codecov

About

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

Flow types

Tags Pinterest 500px Instagram
Flipboard Facebook Flickr

Overview

  • 7 popular flow-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: 9.0+
Swift: 4.1
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 flow layouts is pretty easy:

var contentFlowLayout: ContentDynamicLayout = TagsStyleFlowLayout()

contentFlowLayout?.delegate = self
contentFlowLayout?.contentPadding = ItemsPadding(horizontal: 10, vertical: 10)
contentFlowLayout?.cellsPadding = ItemsPadding(horizontal: 8, vertical: 8)
contentFlowLayout?.contentAlign = .left

collectionView.collectionViewLayout = contentFlowLayout!
collectionView.reloadData()

Also, you have to implement ContentDynamicLayoutDelegate protocol:

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

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

Author

Sergey Afanasiev

Getting Help

[email protected]

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!

About

A library that implements custom flow layouts for iOS apps

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 97.9%
  • Ruby 2.1%