KRLCollectionViewGridLayout 1.0.0

KRLCollectionViewGridLayout 1.0.0

LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Oct 2017

Maintained by Kevin Lundberg.

  • By
  • Kevin Lundberg

This layout is an alternative to UICollectionViewFlowLayout that positions and sizes items using a defined number of columns and an aspect ratio property which force the size of cells, rather than the cells' size telling the layout how to position them (in the way UICollectionViewFlowLayout behaves). By default, this will always show the same number of items in a row no matter how large or small the collection view is.

You can specify the number of items per line and the desired aspect ratio of all items (which is always width / height, regardless of scroll direction):

layout.numberOfItemsPerLine = 5;
layout.aspectRatio = 16.0/9.0;

You can specify metrics similar to UICollectionViewFlowLayout, like so:

layout.sectionInset = UIEdgeInsetsMake(10,20,30,40);
layout.interitemSpacing = 15;
layout.lineSpacing = 5;
layout.scrollDirection = UICollectionViewScrollDirectionVertical;

You can also add headers and footers to each section similar to UICollectionViewFlowLayout:

layout.headerReferenceLength = 44;
layout.footerReferenceLength = 100;

In vertical scrolling mode, length is the height of the header/footer. In horizontal scrolling mode, length is the width of the header/footer.
A length of 0 in these dimensions will not try to create a view.

All of the above properties (except for scrollDirection) can be configured on a per-section basis using KRLCollectionViewDelegateGridLayout. Have your view controller or other object that implements the regular UICollectionViewDelegate also implement this protocol to make these per-section variances for these properties happen.


To run the example project, clone the repo, and run pod install from the Example directory first.
You can either run unit tests on the library itself, or run the sample project for a visual demonstration.


  • iOS 6.0
  • tvOS 9.0

Example project requires Xcode 8.0+, can only run in iOS 8.0+ or tvOS 9.0+.


Kevin Lundberg, kevin at klundberg dot com


Pull requests are welcome! Please include unit tests for any bugfixes or new features.


KRLCollectionViewGridLayout is available under the MIT license. See the LICENSE file for more info.