• Stars
    star
    281
  • Rank 147,023 (Top 3 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created almost 10 years ago
  • Updated almost 9 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

iOS Custom UIScrollView Class to display static text / views with a vertical parallax effect

MMParallaxPresenter

Description

MMParallaxPresenter is a UIScrollView that displays text / views with a vertical parallex effect.

Requirements

  • ARC
  • iOS 5.0+

Installation

  1. MMParallaxPresenter can be installed via CocoaPods by adding pod 'MMParallaxPresenter' to your podfile, or you can manually add MMParallaxPage.h/.m and MMParallaxPresenter.h/.m into your project.
  2. Drag and drop a UIScrollView into your Interface Builder and under the custom class section, subclass your UIScrollView to MMParallaxPresenter
  3. Now add: @property (weak, nonatomic) IBOutlet MMParallaxPresenter *mmParallaxPresenter; to your list of properties and dont forget to link it up in your Interface Builder

Usage

Add a MMParallaxPage to the MMScrollPresenter. To do this, you have three init methods at your disposal. All the default views are shown in the above gif in this order:

	- (id)initWithScrollFrame:(CGRect)scrollFrame withHeaderHeight:(int)height 
		andContentText:(NSString *)contentText;
	
	- (id)initWithScrollFrame:(CGRect)scrollFrame withHeaderHeight:(int)height 
		withContentText:(NSString *)contentText andContextImage:(UIImage *)image;
	
	- (id)initWithScrollFrame:(CGRect)scrollFrame withHeaderHeight:(int)height 
		andContentView:(UIView *)contentView;

This shows how to initalize and setup a page and add it to your presenter:

	MMParallaxPage *page1 = [[MMParallaxPage alloc] 
		initWithScrollFrame:self.mmParallaxPresenter.frame 
		withHeaderHeight:150 andContentText:[self sampleText]];
		
	page1.headerLabel.text = @"Section 1";
	
	[page1.headerView addSubview:[[UIImageView alloc] 
		initWithImage:[UIImage imageNamed:@"stars.jpeg"]]];
	
	[self.scrollView addParallaxPageArray:@[page1]];

License

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