Latest 0.2.1
Homepage https://github.com/azfx/SimpleTab
License MIT
Platforms ios 8.0, requires ARC
Authors

image

CI Status
Version
License
Platform

About

. .
image image

SimpleTab provides an easy alternative to the default UITabBarController with following support :

  • Custom UI for Tab Bar Item
  • Custom Tab Bar Item Animations on Tab Switching
  • Custom View Transitions on Tab Switching

SimpleTab is developed with following principles :

  • Simple – Easy to use and revert
  • Keep the wheel – Utilize core features of UITabBarController
  • Flexible – Provide hooks to customize UI and Animations

Note: At the moment, SimpleTab does not work when used programmatically. It must be used along with UITabBarController set in Storyboard.

Demo

The included example project demonstrates the usage of SimpleTab

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • iOS 8.0+
  • ARC

Installation

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

pod "SimpleTab"

Note: SimpleTab now supports Swift 3.X starting 0.2.0 version.

Getting Started

1.0 Import SimpleTab Framework to your Project

#import SimpleTab

2.0 Using Interface Builder, ensure :

  • Tab Bar Controller is set as SimpleTabBarController
  • Tab Bar is set as SimpleTabBar
  • Tab Bar Item is set as SimpleTabBarITem

3.0 Get Handle to Tab Bar Controller, preferably in AppDelegate

simpleTBC = self.window!.rootViewController as? SimpleTabBarController

4.0 Set View Transition

Included Animations

  • PopViewTransition
  • CrossFadeTransition
simpleTBC?.viewTransition = PopViewTransition()

5.0 Set Tab Bar Style

Included Styles

  • PopTabBarStyle
  • ElegantTabBarStyle
var style:SimpleTabBarStyle = PopTabBarStyle(tabBar: simpleTBC!.tabBar)

5.1 Optional – Set Tab Title attributes for selected and unselected (normal) states.
Or use Tint Color in the Interface Builder to set the states

style.setTitleTextAttributes([NSFontAttributeName : UIFont.systemFontOfSize(14),  NSForegroundColorAttributeName: UIColor.lightGrayColor()], forState: .Normal)
style.setTitleTextAttributes([NSFontAttributeName : UIFont.systemFontOfSize(14),NSForegroundColorAttributeName: colorWithHexString("4CB6BE")], forState: .Selected)

5.2 Optional – Set Tab Icon colors for selected and unselected (normal) states.
Or use the App tint color to set the states

style.setIconColor(UIColor.lightGrayColor(), forState: UIControlState.Normal)
style.setIconColor(UIColor.blueColor(), forState: UIControlState.Selected)

6.0 And finally, let Tab Bar Controller know of the style in use

simpleTBC?.tabBarStyle = style

Customizations

Refer customizations

Author

azfx, [email protected]

License

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

Latest podspec

{
    "name": "SimpleTab",
    "version": "0.2.1",
    "summary": "A Simple iOS Tab Bar Controller with animation support.",
    "description": "SimpleTab is a simple tab bar controller for iOS 8 and above, which extends the default UITabBarController class with customization support for :n* Tab Item Custom UIn* Tab Item Animationsn* View Transitions",
    "homepage": "https://github.com/azfx/SimpleTab",
    "license": "MIT",
    "authors": {
        "azfx": "[email protected]"
    },
    "source": {
        "git": "https://github.com/azfx/SimpleTab.git",
        "tag": "0.2.1"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "source_files": "Pod/Classes/**/*",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This