Latest 3.3.7
Homepage https://github.com/m6666/MXSegmentedPager
License MIT
Platforms ios 7.0, requires ARC
Dependencies HMSegmentedControl, MXPagerView, MXParallaxHeader
Authors

MXSegmentedPager

CI Status
Version
Carthage compatible
License
Platform
Dependency Status

MXSegmentedPager combines MXPagerView with HMSegmentedControl to control the page selection. The integration of MXParallaxHeader allows you to add an parallax header on top while keeping a reliable scrolling effect.

Simple view Parallax view
Demo Demo

Highlight

  • HMSegmentedControl is a very customizable control.
  • MXParallaxHeader supports any kind of view with different modes.
  • MXPagerView lazily loads pages and supports reusable page registration.
  • Reliable vertical scroll with any view hierarchy.
  • Can load view-controller from storyboard using a custom segue.
  • Fully documented.

Usage

  • MXSegmentedPager calls data source methods to load pages.
#pragma mark <MXSegmentedPagerDataSource>

// Asks the data source to return the number of pages in the segmented pager.
- (NSInteger)numberOfPagesInSegmentedPager:(MXSegmentedPager *)segmentedPager {
    return 10;
}

// Asks the data source for a title realted to a particular page of the segmented pager.
- (NSString *)segmentedPager:(MXSegmentedPager *)segmentedPager titleForSectionAtIndex:(NSInteger)index {
    return [NSString stringWithFormat:@"Page %li", (long) index];
}

// Asks the data source for a view to insert in a particular page of the pager.
- (UIView *)segmentedPager:(MXSegmentedPager *)segmentedPager viewForPageAtIndex:(NSInteger)index {

    UILabel *label = [UILabel new];
    label.text = [NSString stringWithFormat:@"Page #%i", index];
    label.textAlignment = NSTextAlignmentCenter;;

    return label;
}
  • Adding a parallax header to a MXSegmentedPager is straightforward, e.g:
UIImageView *headerView = [UIImageView new];
headerView.image = [UIImage imageNamed:@"success-baby"];
headerView.contentMode = UIViewContentModeScaleAspectFill;

MXSegmentedPager *segmentedPager = [MXSegmentedPager new]; 
segmentedPager.parallaxHeader.view = headerView;
segmentedPager.parallaxHeader.height = 150;
segmentedPager.parallaxHeader.mode = MXParallaxHeaderModeFill;
segmentedPager.parallaxHeader.minimumHeight = 20;

Examples

If you want to try it, simply run:

pod try MXSegmentedPager

Or clone the repo and run pod install from the Example directory first.

  • See MXSimpleViewController for a standard implementation.
  • See MXParallaxViewController to implement a pager with a parallax header.
  • See MXExampleViewController for a MXSegmentedPagerController subclass example.

This repo also provides a Swift example project, see Example-Swift.

Installation

MXSegmentedPager is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod 'MXSegmentedPager'

Documentation

Documentation is available through CocoaDocs.

Author

Maxime Epain

Twitter

License

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

Latest podspec

{
    "name": "M6SegmentedPager",
    "version": "3.3.7",
    "summary": "Segmented pager view with Parallax header.",
    "description": "MXSegmentedPager combines [MXPagerView](https://github.com/maxep/MXPagerView) with [HMSegmentedControl](https://github.com/M6666/HMSegmentedControl) to control the page selection.nThe integration of [MXParallaxHeader](https://github.com/maxep/MXParallaxHeader) allows you to add an parallax header on top while keeping a reliable scrolling effect.nnFrok from [MXSegmentedPager](https://github.com/maxep/MXSegmentedPager), fix the pattern of HMSegmentedControl.",
    "homepage": "https://github.com/m6666/MXSegmentedPager",
    "license": "MIT",
    "authors": {
        "m6": "[email protected]"
    },
    "source": {
        "git": "https://github.com/M6666/MXSegmentedPager.git",
        "tag": "3.3.7"
    },
    "platforms": {
        "ios": "7.0"
    },
    "requires_arc": true,
    "source_files": "MXSegmentedPager/*.{m,h}",
    "public_header_files": [
        "MXSegmentedPager/*.h"
    ],
    "dependencies": {
        "HMSegmentedControl": [
            "1.5.4"
        ],
        "MXPagerView": [
            "0.2.1"
        ],
        "MXParallaxHeader": [
            "0.6.1"
        ]
    }
}

Pin It on Pinterest

Share This