APParallaxHeader

This category makes it super easy to add a parallax header view to your scroll views. Other alternatives relies on subclassing of UIScrollView, UITableViewController or UITableView. Instead APParallaxHeader uses the Objective-C runtime to add the two following methods to UIScrollView without the need to do any subclassing.

- (void)addParallaxWithImage:(UIImage *)image andHeight:(CGFloat)height andShadow:(BOOL)shadow;
- (void)addParallaxWithImage:(UIImage *)image andHeight:(CGFloat)height;
- (void)addParallaxWithView:(UIView*)view andHeight:(CGFloat)height;

Demo

Installation

From CocoaPods

Add pod 'APParallaxHeader' to your Podfile (or pod 'APParallaxHeader', :head if you're feeling adventurous, and want to live on the edge).

Manually

Important note if your project doesn't use ARC: you must add the -fobjc-arc compiler flag to UIScrollView+ APParallaxHeader.m in Target Settings > Build Phases > Compile Sources.

Drag the APParallaxHeader/APParallaxHeader folder into your project.
#import UIScrollView+APParallaxHeader.h wherever you feel the need.

Usage

(see sample Xcode project in /Demo)

Adding Parallax image

[tableView addParallaxWithImage:[UIImage imageNamed:@"ImageName"] andHeight:160];

Adding Parallax custom view

Note: When adding a custom view. Either use APParallaxViewDelegate, auto layout constraints or contentMode to resize your custom view during scrolling.

UIView *customView = [[UIView alloc] init];
[customView setFrame:CGRectMake(0, 0, 320, 160)];
[self.tableView addParallaxWithView:customView andHeight:160];

[self.tableView.parallaxView setDelegate:self];

APParallaxViewDelegate

APParallaxViewDelegate will notify the delegate about resizing of the parallax view.

####Methods:####

- (void)parallaxView:(APParallaxView *)view willChangeFrame:(CGRect)frame
- (void)parallaxView:(APParallaxView *)view didChangeFrame:(CGRect)frame

ToDo

Ability to customize the drop shadow size, opacity, color etc.
Setting a minimum height
Setting contentMode of the imageView

Known issues

Section headers for tableviews with style UITableViewStylePlain will not be pinned as expected during scrolling.

Changelog

0.1.6

Re-added/fixed optional shadow implementation

0.1.5

Added delegate callbacks for APParallaxView resizes (APParallaxViewDelegate).

0.1.4

Ability to inititate with or without an inner shadow.
Ability to set a custom view as a parallax view.

0.1.3

Added an inner shadow

0.1.2

Initial release

Credits

APParallaxHeader is brought to you by Mathias Amnell at Apping AB. The code is inspired by Sam Vermette's work with SVPullToRefresh (especially the usage of objc/runtime.h to make it so easy to implement, without the need of subclassing).

License

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

sjrmanning / apparallaxheader Goto Github PK