SlidingTabbarController

Scrollable SlidingTabbarController for iOS

Are you limited to UITabbar's item count? Do you want to impress your customers?

Don't restrict your app to use side menu when you have too many menu items. Use SlidingTabbarController to have smart tab bar on your apps.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate SlidingTabbarController into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

pod 'SlidingTabbarController'

Then, run the following command:

$ pod install

Manually

If you don't want to use CocoaPods you can manually add SlidingTabbarController to your project. Copy swift classes inside Pod/Classes folder and add to your XCode project.

How to use

Using SlidingTabbarController is easy.

• Go to applicationDidFinishLaunchingWithOptions method inside your project's AppDelegate

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
  
  ...
  
  return true
}

• Create a SlidingTabbarController instance,

let slidingTabbarController = SlidingTabbarController()

• Set the items

slidingTabbarController.items = [
  SlidingTabbarItem(image: UIImage(named: "alligator")!,
    highlightedImage: UIImage(named: "alligator_filled")!,
    title: "Alligator",
    controller: ViewController(imageName: "alligator_large")),
  SlidingTabbarItem(image: UIImage(named: "bird")!,
    highlightedImage: UIImage(named: "bird_filled")!,
    title: "Bird",
    controller: ViewController(imageName: "bird_large"))
  ]

• Create a window and make SlidingTabbarController be window's rootViewController

window = UIWindow(frame: UIScreen.mainScreen().bounds)
window!.makeKeyAndVisible()
window!.rootViewController = slidingTabbarController

That is it!

What is SlidingTabbarItem?

SlidingTabbarItem consists of three major elements an image, a title and a controller. Image and title are for showing the corresponding button on the tabbar for the controller. Also, there is highlightedImage to indicate which controller is selected and shown on the screen.

var slidingTabbarItem = SlidingTabbarItem()
item.image = UIImage(named: "show_me_when_passive")
item.highlightedImage = UIImage(named: "show_me_when_active")
item.title = "describe_the_controller"
item.controller = UIViewController() //the content you want to show

Using with UIStoryboard

SlidingTabbarController can be used with storyboard controllers by instantiating controllers from storyboard.

let storyboard = UIStoryboard(name: "Storyboard_Name", bundle: bundleObject)
let controller = storyboard.instantiateViewControllerWithIdentifier("view_controller_identifier")!

Than use this controller with SlidingTabbarItem

slidingTabbarController.items = [
  SlidingTabbarItem(image: UIImage(named: "image_name")!,
    highlightedImage: UIImage(named: "image_name")!,
    title: "An Item",
    controller: controller),
    
    ...
    
  ]