MXPagerView is a pager view with the ability to reuse pages like you would do with a table view and cells. Depending on the transition style, it will load the current page and neighbors and unload others pages.
MXPagerViewController allows you to load pages from storyboard using the MXPageSegue.
If you want to try it, simply run:
pod try MXPagerView
Or clone the repo and run pod install
from the Example directory first.
- As a UITableView, the MXPagerView calls data source methods to load pages.
#pragma mark <MXPagerViewDataSource>
// Asks the data source to return the number of pages in the pager.
- (NSInteger)numberOfPagesInPagerView:(MXPagerView *)pagerView {
return 10;
}
// Asks the data source for a view to insert in a particular page of the pager.
- (UIView *)pagerView:(MXPagerView *)pagerView viewForPageAtIndex:(NSInteger)index {
UILabel *label = [UILabel new];
label.text = [NSString stringWithFormat:@"Page #%i", index];
[label sizeToFit];
return label;
}
- In order to reuse pages, first register the reusable view, e.g:
- (void)viewDidLoad {
[super viewDidLoad];
//Register UITextView as page
[self.pagerView registerClass:[UITextView class] forPageReuseIdentifier:@"TextPage"];
}
Then, dequeue a reusable page in the data source:
// Asks the data source for a view to insert in a particular page of the pager.
- (UIView *)pagerView:(MXPagerView *)pagerView viewForPageAtIndex:(NSInteger)index {
//Dequeue reusable page
UITextView *page = [self.pagerView dequeueReusablePageWithIdentifier:@"TextPage"];
page.text = @"This is a text";
return page;
}
The MXPagerView comes with a UIView category which exposed the reuse identifier of the page as well as the prepareForReuse
method, this is called just before the page is returned from the pager view method dequeueReusablePageWithIdentifier:
.
- Using MXPagerViewController in storyboard is super easy:
MXPagerView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "MXPagerView"
Documentation is available through CocoaDocs.
MXPagerView is available under the MIT license. See the LICENSE file for more info.