akpw / akpflowlayout

A custom UICollectionView layout with configurable global header and pinnable / stretchable sections (Swift 3 / Xcode 8.x)

AKPFlowLayout

AKPFlowLayout is a custom Collection View layout with configurable global header and pinnable, stretchable sections.

Blogs

• Custom UICollectionView: Global Headers

Sample App

• SwiftNetworkImages

Features

• A custom UICollectionViewFlowLayout-based layout with support for:

• Global header
• Sticky section headers
• Pinnable, stretchable sections

• Fully configurable

• Built for performace using custom invalidation context

• Written in Swift 3 and Xcode 8

Requirements

• iOS 8+
• Xcode 8
• Swift 3

Installation

CocoaPods (recommended)

use_frameworks!
pod 'AKPFlowLayout'

Carthage

1. Add AKPFlowLayout to your Cartfile:

   github "akpw/AKPFlowLayout"
   

2. Follow the Carthage instructions on adding frameworks for further reference

Docs

Initial docs, generated with jazzy and hosted by GitHub Pages.

Building the project

1. Clone the repository

$ git clone https://github.com/akpw/AKPFlowLayout

2. Run carthage.sh

$ cd AKPFlowLayout
$ ./carthage.sh

3. Open the workspace in Xcode

$ open "AKPFlowLayout.xcworkspace"

4. Compile and test in Xcode

akpflowlayout's Issues

Incorrectly positioning section Headers for sections with no items (headers only)

In a collection view similar to the "SwiftNetworkImages" demo, the first section is used for the global section, and the second section, with a floating header, is where items are displayed.
When a fetch returns no data, the header of the 2nd section is displayed at offset 0,0, instead of under the top section. The issues is caused inside boundaryMetrics, which returns (0, 0) for empty sections.

Please see a fix to this issue in a separate fork.

Moving header on inserting section while scrolling

Hello @akpw,

to be honest I'm investigating this issue already when I used a "standard" UICollectionView with sectionHeadersPinToVisibleBounds. But because you seem a person with a deep know-how with collection view layouts, I ask you for some help.

I also see this issue when I use your implementation of sticky headers.

Issue:

If I insert a new section and scroll to this new section, then the first sticky header is moving with a strange animation. It is only happening when I set the content inset of the collection view to something unlike zero.
For me it doesn't make sense at all and i tried everything to work around, but nothing helps.

It would be great to get in contact because I think you could help me! :)

Kind regards
Jochen