Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zenangst/Blueprints

:cyclone: Blueprints - A framework that is meant to make your life easier when working with collection view flow layouts.
https://github.com/zenangst/Blueprints

flowlayout ios layout macos swift tvos uicollectionview uicollectionview-animation uicollectionview-cell uicollectionviewlayout

Last synced: about 1 month ago
JSON representation

:cyclone: Blueprints - A framework that is meant to make your life easier when working with collection view flow layouts.

Awesome Lists containing this project

README 

        
![Blueprints logo](Images/Blueprints-header.png?raw=true)

![Blueprints Preview](Images/Blueprints-Preview.png?raw=true "Blueprints Preview")






[![CI Status](https://travis-ci.org/zenangst/Blueprints.svg?branch=master)](https://travis-ci.org/zenangst/Blueprints)

[![Version](https://img.shields.io/cocoapods/v/Blueprints.svg?style=flat)](http://cocoadocs.org/docsets/Blueprints)

[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

![Code Coverage](https://codecov.io/github/zenangst/Blueprints/coverage.svg?branch=master)

[![License](https://img.shields.io/cocoapods/l/Blueprints.svg?style=flat)](http://cocoadocs.org/docsets/Blueprints)

[![Platform](https://img.shields.io/cocoapods/p/Blueprints.svg?style=flat)](http://cocoadocs.org/docsets/Blueprints)

![Swift](https://img.shields.io/badge/%20in-swift%205.0-orange.svg)






## Description



Blueprints Icon



Blueprints is a collection of flow layouts that is meant to make your life easier when working with collection view flow layouts. It comes with two built-in layouts that are highly flexible and easy to configure at the call-site. They support properties like items per row and items per column; this will calculate the layout attributes needed for fitting the number of views that you want to appear on the screen.



The framework also provides a good base for your custom implementations. By extending the core blueprint layout, you get built-in support for animations and layout attribute caching. The bundled default animator supports animations that look very similar to what you get from a vanilla table view. If you want to provide your collection view animator, no problem; you can inject an animator of your choosing when initializing the layout.



## Features



- [x] 🍭 Animation support

- [x] 🤳🏻 Optimized for performance

- [x] 📏 Built-in vertical and horizontal layouts

- [x] 📰 Supports header and footers

- [x] 🖍 Supports sticky headers and footers

- [x] 🌈 Built-in mosiac layout

- [x] 💦 Built-in vertical layout that supports waterfall

- [x] 📱 iOS support

- [x] 💻 macOS support

- [x] 📺 tvOS support

- [x] 🦖 Objective-C support



## Supporting the project



If you want to support the development of this framework, you can do so by becoming a [sponsor](https://github.com/sponsors/zenangst). ❤️



## Preview



| iOS   | macOS  |

| ------------ | ------------ |

| iOS PReview  | ![macOS Preview](Images/OSX-Preview.gif?raw=true)  |



## How do items per row work?



If you specify how many items per row that you want to appear in a vertical layout, the width of the layout attribute will be calculated for you taking the section inset, item spacing into account to make sure that all views fit your design. For example, if you set that you want two items per row, then two views will appear on the same row side by side. If you want to create a table view layout, you would simply set the items per row value to be one. You can use this variable for horizontal layouts as well, but instead of creating a new row, the value is used to create a width to cover the desired area. If you want the width to span across the entire container then simply set it to one, if you want to create a carousel layout with hinting, setting a value like 1.1 will render at least one complete item and give a visual hint to the user that another view is available if the scroll horizontally.



## How do items per column work?



Items per column are explicitly for horizontal layouts and are used to decide how many items that should be shown on screen but using a vertical axis. If you set it to two, it will display two views, one above and one below and then continue to build the rest of the views horizontally, following the same pattern.



## How does item sizes work?



It works just like a regular flow layout, but with a twist. If you want to provide a static size using the regular item size, you are free to do so. As mentioned above, you can also provide the number of views that you want visible on the screen based on the container views width.

To provide dynamic sizing, you can make your collection view delegate conform to `UICollectionViewDelegateFlowLayout` or `NSCollectionViewDelegateFlowLayout`. That way you can compute the values based on the data coming from the data source etc. Worth noting is that using itemsPerRow takes precedence over the other alternatives.



#### Dynamic sizing preview






## Usage



### Vertical layout

```swift

let blueprintLayout = VerticalBlueprintLayout(

  itemsPerRow: 1.0,

  height: 50,

  minimumInteritemSpacing: 10,

  minimumLineSpacing: 10,

  sectionInset: EdgeInsets(top: 10, left: 10, bottom: 10, right: 10),

  stickyHeaders: true,

  stickyFooters: false

)

let collectionView = UICollectionView(frame: .zero,

                                      collectionViewLayout: blueprintLayout)

```



### Horizontal layout

```swift

let blueprintLayout = HorizontalBlueprintLayout(

  itemsPerRow: 1.0,

  itemsPerColumn: 2,

  height: 50,

  minimumInteritemSpacing: 10,

  minimumLineSpacing: 10,

  sectionInset: EdgeInsets(top: 10, left: 10, bottom: 10, right: 10),

  stickyHeaders: true,

  stickyFooters: true

)

let collectionView = UICollectionView(frame: .zero,

                                      collectionViewLayout: blueprintLayout)

```



### Mosaic layout

```swift

let mosaicLayout = VerticalMosaicBlueprintLayout(

  patternHeight: 400,

  minimumInteritemSpacing: 2,

  minimumLineSpacing: 2,

  sectionInset: EdgeInsets(top: 2, left: 2, bottom: 2, right: 2),

  patterns: [

    MosaicPattern(alignment: .left, direction: .vertical, amount: 2, multiplier: 0.6),

    MosaicPattern(alignment: .left, direction: .horizontal, amount: 2, multiplier: 0.33),

    MosaicPattern(alignment: .left, direction: .vertical, amount: 1, multiplier: 0.5),

    MosaicPattern(alignment: .left, direction: .vertical, amount: 1, multiplier: 0.5)

  ])

let collectionView = UICollectionView(frame: .zero,

                                      collectionViewLayout: mosaicLayout)

```



## Installation



**Blueprints** is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:



```ruby

pod 'Blueprints'

```



**Blueprints** is also available through [Carthage](https://github.com/Carthage/Carthage).

To install just write into your Cartfile:



```ruby

github "zenangst/Blueprints"

```



**Blueprints** can also be installed manually. Just download and drop `Sources` folders in your project.



## Author(s)



- Christoffer Winterkvist, [@zenangst](https://github.com/zenangst)

- Christopher Roberts, [@christoff-1992](https://github.com/christoff-1992)



## Contributing



We would love you to contribute to **Blueprints**, check the [CONTRIBUTING](https://github.com/zenangst/Blueprints/blob/master/CONTRIBUTING.md) file for more info.



## License



**Blueprints** is available under the MIT license. See the [LICENSE](https://github.com/zenangst/Blueprints/blob/master/LICENSE.md) file for more info.