Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maxep/MXPagerView
Pager view with reusable page and storyboard support.
https://github.com/maxep/MXPagerView
ios pager reuse-pages storyboard
Last synced: about 1 month ago
JSON representation
Pager view with reusable page and storyboard support.
- Host: GitHub
- URL: https://github.com/maxep/MXPagerView
- Owner: maxep
- License: mit
- Created: 2015-11-08T23:17:48.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-10-21T18:09:10.000Z (about 5 years ago)
- Last Synced: 2024-11-01T00:04:02.808Z (about 1 month ago)
- Topics: ios, pager, reuse-pages, storyboard
- Language: Objective-C
- Size: 271 KB
- Stars: 67
- Watchers: 4
- Forks: 39
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - MXPagerView - Pager view with reusable page and storyboard support. (storyboard)
- awesome - MXPagerView - Pager view with reusable page and storyboard support. (ios)
README
# MXPagerView
[](https://travis-ci.org/maxep/MXPagerView)
[](http://cocoapods.org/pods/MXPagerView)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/MXPagerView)
[](http://cocoapods.org/pods/MXPagerView)
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.
## Usage
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.
```objective-c
#pragma mark
// 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:
```objective-c
- (void)viewDidLoad {
[super viewDidLoad];
//Register UITextView as page
[self.pagerView registerClass:[UITextView class] forPageReuseIdentifier:@"TextPage"];
}
```
Then, dequeue a reusable page in the data source:
```objective-c
// 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:
## Installation
MXPagerView is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "MXPagerView"
```
## Documentation
Documentation is available through [CocoaDocs](http://cocoadocs.org/docsets/MXPagerView/).
## Author
[Maxime Epain](http://maxep.github.io)
[](https://twitter.com/MaximeEpain)
## License
MXPagerView is available under the MIT license. See the [LICENSE](LICENSE) file for more info.