Tabman is a powerful paging view controller with indicator bar, for iOS.

Features

• Super easy to implement page view controller with indicator bar.
• Multiple indicator bar styles.
• Simplistic, yet highly extensive customisation.
• Full support for custom components.
• Built on a powerful and informative page view controller, Pageboy.

Installation

CocoaPods

Tabman is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Tabman'

And run pod install.

Carthage

Tabman is also available through Carthage. Simply install carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

Add Tabman to your Cartfile:

github "uias/Tabman" 

Dependencies

• Pageboy by Merrick Sapsford
• PureLayout by PureLayout

Example

A nice pretty example project is available to take a look at some of the features that Tabman offers. To run the example, simply clone the repo, run

carthage bootstrap --platform ios

and build the workspace.

Requirements

Tabman requires iOS 9.0 or above.

Usage

Getting Started

1. Create an instance of TabmanViewController and provide it with a PageboyViewControllerDataSource. Note: TabmanViewController conforms to and is set as the PageboyViewControllerDelegate.

class YourTabViewController: TabmanViewController, PageboyViewControllerDataSource {

	override func viewDidLoad() {
		super.viewDidLoad()

		self.dataSource = self
	}
}

2. Implement the PageboyViewControllerDataSource and configure the bar for display.

func viewControllers(forPageboyViewController pageboyViewController: PageboyViewController) -> [UIViewController]? {
    // return array of view controllers
    let viewControllers = [viewController1, viewController2]

    // configure the bar
    self.bar.items = [TabmanBarItem(title: "Page 1"),
                      TabmanBarItem(title: "Page 2")]

    return viewControllers
}

func defaultPageIndex(forPageboyViewController pageboyViewController: PageboyViewController) -> PageboyViewController.PageIndex? {
    // use default index
    return nil
}

3. All done! 🎉

Going forward

As Tabman is based on Pageboy, everything behaves the same and all the same properties/functions are available. Such as these functions for navigation & reloading:

// Scroll the page view controller to a new page.
public func scrollToPage(_ pageIndex: PageIndex,
                         animated: Bool,
                         completion: PageTransitionCompletion? = nil)

// Reload the view controllers in the page view controller.                         
public func reloadPages()

Read up on the Pageboy docs to find out a bit more here.

Child Content Insetting

Tabman will automatically inset any UITableView or UICollectionView's that are in the child view controllers provided to the PageboyViewControllerDataSource. This behaviour can easily be disabled:

tabmanViewController.automaticallyAdjustsChildScrollViewInsets = false

A requiredInsets property is also available on TabmanBarConfig which provides any insets required to inset content correctly for the visible TabmanBar manually.

Customisation

The TabmanBar in Tabman can be completely customised to your liking, by simply modifying the available properties in the .bar TabmanBarConfig object.

Style

The style of bar to display, by default this is set to .scrollingButtonBar.

Available Styles:

For examples on implementing real-world bar styles with Tabman, check out Tabman-Styles.

Location

Where you want the bar to appear, either at the top or bottom of the screen. By default this is set to .preferred which will use the predefined preferred location for the active style.

The bar will automatically take UIKit components such as UINavigationBar and UITabBar into account.

Appearance

The TabmanBar.Appearance object provides all the available properties for appearance customisation of a TabmanBar. Not all of the properties are appropriate for each style TabmanBar, therefore the bar will only respond to the properties it adheres to.

To set a custom appearance definition do the following on a TabmanViewController:

tabViewController.bar.appearance = TabmanBar.Appearance({ (appearance) in
	// customise appearance here
	appearance.text.color = UIColor.red
	appearance.indicator.isProgressive = true
})

Documentation for all the available appearance properties can be found here: Appearance.

Advanced

For more advanced customisation, including defining your own indicator and bar styles please read here.

Getting In Touch

Please feel free to contact me on Twitter.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/uias/Tabman.

License

The library is available as open source under the terms of the MIT License.