SHViewPager 2.0.7

SHViewPager 2.0.7

LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Oct 2016

Maintained by Shabib Hossain.

  • A simple view pager for iOS, which acts similar to android's viewPager. Compatible with iOS 8.0 or later. Supports iPhones and iPads in all interface orientation.

Table of contents


iPhone interface:

iPhone screen

iPad interface:

iPad screen


  • [x] Supports both Swift (v2.2 and v3.0) and Objective-C
  • [x] Supports all orientations
  • [x] Supports iPad
  • [x] Supports Autolayout

Demo project

Fully workable examples; both in Objective-C and Swift; are included. If you want to try it yourself, just download/checkout this repository, and run pod install from the Example directory first. Then open the SHViewPager.xcworkspace with Xcode.


  • Xcode 6+
  • iOS 8+
  • ARC


Source files

  1. Download the latest code version or add the repository as a git submodule to your git-tracked project.
  2. Drag and drop the Classes and the Resources directory from the archive in your project navigator. Make sure to select Copy items when asked if you extracted the code archive outside of your project.

Use SHViewPager wherever you need it with #import <SHViewPager/SHViewPagerModule.h> in Objective-C and import SHViewPager in Swift.

How to use

The SHViewPager needs it's datasource and delegate protocols to be implemented. Simply initialize it from code or better:

Method 1

  1. Drag and drop an UIView from the Storyboard to your UIViewController.
  2. Change the class to SHViewPager, and
  3. Finally connect the datasource, delegate and your property IBOutlet.

Method 2

  1. Drag and drop an UIViewController to the Storyboard.
  2. Change the class to SHViewPagerController

Four datasource methods are required and others are optional.

Objective-C: The required datasource methods are

- (NSInteger)numberOfPagesInViewPager:(SHViewPager *)viewPager;
- (UIViewController *)containerControllerForViewPager:(SHViewPager *)viewPager;
- (UIViewController *)viewPager:(SHViewPager *)viewPager controllerForPageAtIndex:(NSInteger)index;


- (NSString *)viewPager:(SHViewPager *)viewPager titleForPageMenuAtIndex:(NSInteger)index;


- (UIImage *)viewPager:(SHViewPager *)viewPager imageForPageMenuAtIndex:(NSInteger)index;

Swift: The required datasource methods are

func numberOfPages(in viewPager: SHViewPager) -> Int
func containerController(for viewPager: SHViewPager) -> UIViewController
func viewPager(_ viewPager: SHViewPager, controllerForPageAt index: Int) -> UIViewController


func viewPager(_ viewPager: SHViewPager, titleForPageMenuAt index: Int) -> String


func viewPager(_ viewPager: SHViewPager, imageForPageMenuAt index: Int) -> UIImage

To display the contents, you need to call the instance method reloadData in your desired method block; typically in viewDidLoad; and pagerWillLayoutSubviews in viewWillLayoutSubviews.



- (void)viewDidLoad {
    [super viewDidLoad];
    // your code
    [viewPager reloadData];

-(void)viewWillLayoutSubviews {
    [super viewWillLayoutSubviews];
    [_pager pagerWillLayoutSubviews];


override func viewDidLoad() {
    // your code

override func viewWillLayoutSubviews() {

Known Issues

Please refer to the open issue list.


Created by Ahmad Shabibul Hossain, @shabib_hossain on 5/15/14.


Share feedbacks and ideas to improve this project, I would love to hear them out. You can also follow me on @shabib_hossain.


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