ViewPager-Swift

An easy to use view pager library for iOS in Swift based on UIPageViewController and Scroll View along with multiple customization options and tap as well as swipe gesture for changing between pages.

##Installation

Just add ViewPagerController.swift and ViewPagerOptions.swift file to your project.Both files are present inside ViewPager-Swift directory.

##Screenshots

##How to use##

Customize your View Pager with the help of ViewPagerOptions class
Pass that options to ViewPagerController and set its datasource
That's it

During its initialization, default options are set for view pager. So just this single line is enough if you want to use default configuration.

let myOptions= ViewPagerOptions(inView: self.view)

For further customization,

//If I want my tabs to be of equal width
myOptions.isEachTabEvenlyDistributed = true

//If I don't want my tab to get highlighted for page
myOptions.isTabViewHighlightAvailable = false

//If I want indicator bar to show below current page tab
myOptions.isTabIndicatorViewAvailable= true

//Oh! and let's change color of tab to red
myOptions.tabViewBackgroundColor = UIColor.redColor()

//and many more...

let viewPager = ViewPagerController()
viewPager.options = myOptions
viewPager.dataSource = self

//Now let me add this to my viewcontroller
self.addChildViewController(viewPager)
self.view.addSubView(viewPager.view)
viewPager.didMoveToParentViewController(self)

That's it. Conform to ViewPagerControllerDataSource and you are good to go. If you want you can conform to ViewPagerControllerDelegate to receive additional feedbacks.

DataSource

let's set datasource

viewPager.dataSource= self

//Okay let me provide it with number of pages required

func numberOfPages()->Int

//I can provide different view controller for different page 

func viewControllerAtPosition(position:Int)->UIViewController

//let me provide titles for all page

func pageTitles() -> [String]

//Yayy! I can start from any page

optional func startViewPagerAtIndex()->Int

Delegate

Let's set delegate

viewPager.delegate = self

Called when transition to another view controller starts but is not completed

optional func willMoveToViewControllerAtIndex(index:Int)

called when transiton to another view controller is completed

optional func didMoveToViewControllerAtIndex(index:Int)

Customization

You can perform lots of customization. If you want to look under the hoods, all the public variables inside ViewPagerOptions.swift file is customizable.

Tab Indicator: Horizontal bar of small thickness which is displayed under tab for current page

TabView: Horizontal bar which contains names of pages.

TabLabel: Each individual tab containing page name

Booleans:

Whether to highlight tab for current page or not, Default is false

isTabViewHighlightAvailable:Bool

Whether to display tab indicator or not, Default is true

isTabIndicatorViewAvailable:Bool

Whether to distribute tabs of even width, If set to true, each tabs width will be equal to largest tab. Default is false.

isEachTabEvenlyDistributed:Bool

Whether to fit all tabs in Screen or not. If set to true, all tabs are squeezed to fit inside frame of view pager.Default is false

fitAllTabsInView:Bool

Tab View and Tab Indicator Height for tab, Default is 50

tabViewHeight:CGFloat

Width for whole tab View, Default is size of viewpager frame

tabViewWidth:CGFloat

Background Color for whole tab View

tabViewBackgroundDefaultColor:UIColor

Background Color for current tab. Only displays if isTabViewHighlightAvailable is set to true

tabViewBackgroundHighlightColor:UIColor

Color for each page title

tabViewTextDefaultColor:UIColor

Color for text for current tab

tabViewTextHighlightColor:UIColor

Padding for each tab, Default is 10

tabLabelPaddingLeft:CGFloat
tabLabelPaddingRight:CGFloat

Height of tab indicator, Default is 3

tabIndicatorViewHeight:CGFloat

Background Color for tab Indicator

tabIndicatorViewBackgroundColor:UIColor

View Pager

Transition style for each page, Default is scroll

viewPagerTransitionStyle:UIPageViewControllerTransitionStyle

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

arshu-dev/ViewPager-Swift

ViewPager-Swift

Customization

License