azfx / simpletab

A Simple iOS Tab Bar Controller with animation support.

About

.	.

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 instantiated programmatically. It must be used along with UITabBarController set in Interface Builder.

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.

simpletab's Issues

crashes when used programatically

`
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    let mainTBC = SimpleTabBarController()
    mainTBC.tabBar = SimpleTabBar()
    mainTBC.viewTransition = PopViewTransition()
    
    let style:SimpleTabBarStyle = PopTabBarStyle(tabBar: mainTBC.tabBar)
    style.setIconColor(color: .lightGray, forState: .normal)
    style.setIconColor(color: .blue, forState: .selected)
    
    mainTBC.tabBarStyle = style
    mainTBC.viewControllers = buildNavigationControllers()
    window?.rootViewController = mainTBC
    return true
}



func buildNavigationControllers()->[UINavigationController]{
    

    let testVC = UIViewController()
    testVC.title = "Test"
    let testNC = UINavigationController()
    testNC.navigationBar.isTranslucent = false
    testNC.viewControllers = [networkVC]
    testNC.tabBarItem = SimpleTabBarItem(title: "Test",
                                     image: UIImage(named:"icon_favorites") ,
                                     selectedImage: UIImage(named:"icon_favorites"))
    
    
    let lastVC = UIViewController()
    lastVC.title = "Test"
    let lastNC = UINavigationController()
    lastNC.navigationBar.isTranslucent = false
    lastNC.viewControllers = [networkVC]
    lastNC.tabBarItem = SimpleTabBarItem(title: "Test",
                                     image: UIImage(named:"icon_favorites") ,
                                     selectedImage: UIImage(named:"icon_favorites"))
    
    return [testNC,lastNC]
    
}`

toBarItem's animation failed

Hi,
I have a problem with this.
When I move to a bar item, its position doesn't change. Shouldn't it go downward?

iconTopOffset and titleBottomOffset not working

I've tried everything I can think of, including manually setting the imageInsets but that didn't affect anything. I have everything setup in a storyboard, but it shouldn't matter. The TabBar items in the storyboard are SimpletabBarItems so the iconTopOffset and titleBottomOffset should work. My goal is to center the icon a little bit more and remove the title.

Disable effects when selected item

Hi
How I can disable tabbaritem text is hidden when it is selected?

Doesn't build in Xcode 7

swift 4.2

Im trying to use with swift 4.2, but i having problens with absoleted functions
can you release a new atty ?
sorry for my inglish, Im from Brasil

How to detect selected item simple tabbar

I want to detected method event didSelect if i when press item on tabbar navigation to another view controller.

Please help me! thank you.

Support for Iphone X

Would like to know if there is planned support for iPhone X in the future, since all constraints and other visuals break when building for iPhone X.

PS. Thank you for this great library.