CSStickyHeaderFlowLayout
Parallax, Sticky Headers, Growing image heading, done right in one UICollectionViewLayout.
Installation
CSStickyHeaderFlowLayout is available through CocoaPods, to install it simply add the following line to your Podfile:
pod "CSStickyHeaderFlowLayout"
Alternatively, you can just drag the files from CSStickyHeaderFlowLayout / Classes
into your own project.
Usage
To run the example project; clone the repo, and run pod install
from the Project directory first.
1. Setting up the Sticky Section Header
Configure your collection view to use CSStickyHeaderFlowLayout
. Here's an example on how you to do it in Storyboard.
Now all your section headers will get the sticky effect like table view. You can disable it with one line of code.
@property (nonatomic) BOOL disableStickyHeaders;
2. Setting up the Collection View Header
We'll be using supplementary views for our parallax header. Here's an example on how use a nib file for that purpose:
Register that nib file to your collection view controller in code:
#import "CSStickyHeaderFlowLayout.h"
- (void)viewDidLoad {
[super viewDidLoad];
// Locate your layout
CSStickyHeaderFlowLayout *layout = (id)self.collectionViewLayout;
if ([layout isKindOfClass:[CSStickyHeaderFlowLayout class]]) {
layout.parallaxHeaderReferenceSize = CGSizeMake(320, 200);
}
// Locate the nib and register it to your collection view
UINib *headerNib = [UINib nibWithNibName:@"CSGrowHeader" bundle:nil];
[self.collectionView registerNib:headerNib
forSupplementaryViewOfKind:CSStickyHeaderParallaxHeader
withReuseIdentifier:@"header"];
}
Implement -[UICollectionViewDataSource collectionView:viewForSupplementaryElementOfKind:atIndexPath:]
- (UICollectionReusableView *)collectionView:(UICollectionView *)collectionView viewForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath {
// Check the kind if it's CSStickyHeaderParallaxHeader
if ([kind isEqualToString:CSStickyHeaderParallaxHeader]) {
UICollectionReusableView *cell = [collectionView dequeueReusableSupplementaryViewOfKind:kind
withReuseIdentifier:@"header"
forIndexPath:indexPath];
return cell;
} else if ([kind isEqualToString:UICollectionElementKindSectionHeader]) {
// Your code to configure your section header...
} else {
// other custom supplementary views
}
return nil;
}
That's it. You'll be able to get the header you wanted using the best practice.
Configuring other effects are really just the way how you setup the header cell, by combining different settings in the minimal exposed properties in CSStickyHeaderFlowLayout.h
@property (nonatomic) CGSize parallaxHeaderReferenceSize;
@property (nonatomic) CGSize parallaxHeaderMinimumReferenceSize;
@property (nonatomic) BOOL disableStickyHeaders;
Run the project examples and it'll shows you exactly how you achieve different effects.
Donation
If you think this worths something, tip me a cup of coffee! (p.s. was trying out ChangeTip, or if you know any better donation button, let me know) :)
Updates
-
0.2.3: Enabled iPhone 6 screen sizes, reverted a patch and fixed a visual bug and content tapping bug.
-
0.2.2: Fix 1px header and zIndex problem, thanks @m1entus and @Xyand
-
0.2.1: Fix crash on reloadData in collection view when header is offscreen, thanks @jessesquires
-
0.2: Added custom UICollectionViewLayoutAttributes to support more advanced example (Spotify App)
-
0.1.1: Minor fixes for default number of sections, thanks @miwillhite
-
0.1: Initial Release
Who's using it?
We've a wiki page for that, feel free to add your projects there!
Requirements
- Xcode 5
- iOS 7 (I haven't really test on iOS 6 but it should work if you're using iOS 6 compatible Storyboard)
Author
James Tang, [email protected]
License
CSStickyHeaderFlowLayout is available under the MIT license. See the LICENSE file for more info.