Skip to content
An easy solution to page controllers like NetEase News
Objective-C Ruby
Branch: master
Clone or download

Latest commit

Latest commit 75ab242 Jul 2, 2018


Type Name Latest commit message Commit time
Failed to load latest commit information.
WMPageController Merge pull request #510 from xilin/master Jul 2, 2018
WMPageControllerDemo 【Optimize】整理代码 Jul 1, 2018
.gitignore Fix multi-select on certain devices Nov 19, 2016 Update Nov 20, 2017
LICENSE Update Sep 26, 2017 Update Jan 20, 2018
WMPageController.podspec 【Bugfix】修复 Podfile 文件错误 Jul 1, 2018

WMPageController 中文介绍

Platform License CocoaPods Version

An easy solution to page controllers like NetEase News


Change Log

See CHANGELOG for more information.

Basic use

Create an controller extends from WMPageController.There are two ways to init the WMPageController:

Init with Classes

Use the following constructor to init the controller:

- (instancetype)initWithViewControllerClasses:(NSArray *)classes 
                               andTheirTitles:(NSArray *)titles;

Here are two important porperties:

classes :contains the classes of child view controllers, just like [UITableViewController class];
titles  :Each View controller's title to show in the menu view at the top of the view;

Use datasource (Recommend This Way!)

The usage is very familiar to UITableView, these are the methods need to implement:

- (NSInteger)numbersOfChildControllersInPageController:(WMPageController *)pageController;

- (__kindof UIViewController *)pageController:(WMPageController *)pageController viewControllerAtIndex:(NSInteger)index;

- (NSString *)pageController:(WMPageController *)pageController titleAtIndex:(NSInteger)index;

Just implement these datasource methods in YOUR WMPageController after initialize it.

Customize Content's Frame

It's easy for you to customize your controller as following, just implement these two datasource methods.

- (CGRect)pageController:(WMPageController *)pageController preferredFrameForContentView:(WMScrollView *)contentView;

- (CGRect)pageController:(WMPageController *)pageController preferredFrameForMenuView:(WMMenuView *)menuView;

When you want to change the frame of contentView, you need to call -forceLayoutSubViews method. This will recall the datasource method above and re-layout subviews. If you are interested, see viewFrameExample for more detail.

Use Storyboard / xib

1.If you init the WMPageController with child controller's class,override the -init method in WMPageController's childViewController, For example:

- (instancetype)init {
    return [self initWithNibName:@"xxxViewController" bundle:nil];

2.If you are using datasource, Just implement -pageController:viewControllerAtIndex: as following:

- (UIViewController *)pageController:(WMPageController *)pageController viewControllerAtIndex:(NSInteger)index {
    UIStoryboard *sb = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
    UIViewController *vc = [sb instantiateViewControllerWithIdentifier:@"WMViewController"];
    return vc;

See StoryboardExample for more detail.


You can easily change style by setting = WMMenuViewStyleLine.
If you want menuView to show on the navigation bar, set .showOnNavigationBar = YES;

Using CocoaPods

If you want the newest version, try 2.4.0 (This has some API modified)

pod 'WMPageController', '~> 2.4.0' 

If you perfer the old, just use 2.3.0 and it's fine.

pod 'WMPageController', '2.3.0' 


  1. If you have any trouble with content controller's frame or size,just try set viewFrame property, which make you free to customize your own size.

  2. You can put every controller in WMPageController,But if you want have a UICollectionViewController in, please have an attention to UICollectionViewController's init method.
    You should override the - init to give UICollectionViewController a UICollectionViewLayout. Here is an example:

- (instancetype)init {
    // init layout here...
    self = [self initWithCollectionViewLayout:layout];
    if (self) {
        // insert code here...
    return self;


This project is under MIT License. See LICENSE file for more information.

You can’t perform that action at this time.