Skip to content

hemangshah/HHTabBarView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

HHTabBarView

A lightweight customized tabbar view.

License Platform Swift 4.x MadeWithLove Awesome-Swift

  1. Screenshots
  2. Features
  3. Installation
  4. Setup
  5. ToDos
  6. Credits
  7. Thanks
  8. License

Screenshots

Only Icon Icon (top) with title (bottom) Only Title
Icon (left) with title (right) Icon (right) with title (left) Icon (bottom) with title (top)
HHTabBarView top position HHTabBarView top position (iPhoneX)
Usage

Features

  1. Easily Configurable and Setup. Create tabs with Title, or Image or both.
  2. Dynamic Tabs Configurations.
  3. Detect Taps in a completion block.
  4. Show/Hide Badge Value in individual tabs. Easily Configure as per the needs.
  5. Lock/Unlock particular tabs.
  6. Easily show/hide UINavigationBar and HHTabBarView.
  7. Lightweight with zero dependancies.
  8. Change UI of HHTabBarView (LeftToRight or RightToLeft) as per the needs.
  9. Change HHTabBarView position as per UI requirements. Supports: Top and Bottom (Default).
Note: I don't recommended displaying HHTabBarView at the top. It's always good at the bottom.

Installation

  1. Manually – Add HHTabBarView/Source folder to your Project. And you're good to use HHTabBarView.

  2. CocoaPods: – pod 'HHTabBarView'

You can read the CHANGELOG file for a particular release.

Setup

Important: Please note that HHTabBarView is currently not supports UIStoryBoard. Means, you will have to create HHTabBarView programmatically. It is advised to setup HHTabBarView in AppDelegate.swift for your easyness.

  1. Initialize and keeping reference of HHTabBarView. πŸ“Œ
    let hhTabBarView = HHTabBarView.shared
  1. Keeping reference of iOS default UITabBarController. πŸ“Œ
    let referenceTabBarController = HHTabBarView.shared.referenceUITabBarController
  1. Setup referenced UITabBarController πŸ“Œ
    func setupReferenceUITabBarController() -> Void {
        
        //Creating a storyboard reference
        let storyboard = UIStoryboard.init(name: "Main", bundle: Bundle.main)
        
        //Creating navigation controller for navigation inside the first tab.
        let navigationController1: UINavigationController = UINavigationController.init(rootViewController: storyboard.instantiateViewController(withIdentifier: "FirstViewControllerID"))
        
        //Creating navigation controller for navigation inside the second tab.
        let navigationController2: UINavigationController = UINavigationController.init(rootViewController: storyboard.instantiateViewController(withIdentifier: "SecondViewControllerID"))
        
        //Update referenced TabbarController with your viewcontrollers
        referenceTabBarController.setViewControllers([navigationController1, navigationController2], animated: false)
    }
  1. Setup HHTabBarView πŸ“Œ
    //Update HHTabBarView reference with the tabs requires.
    func setupHHTabBarView() -> Void {
        
        //Default & Selected Background Color
        let defaultTabColor = UIColor.white
        let selectedTabColor = UIColor.init(red: 234/255, green: 218/255, blue: 195/255, alpha: 1.0)
        let tabFont = UIFont.init(name: "Helvetica-Light", size: 14.0)
        
        //Create Custom Tabs
        let t1 = HHTabButton.init(withTitle: "Calendar", tabImage: UIImage.init(named: "Calendar")!, index: 0)
        t1.titleLabel?.font = tabFont
        t1.titleLabel?.textColor = UIColor.black
        t1.setHHTabBackgroundColor(color: defaultTabColor, forState: .normal)
        t1.setHHTabBackgroundColor(color: selectedTabColor, forState: .selected)
        
        let t2 = HHTabButton.init(withTitle: "Refresh", tabImage: UIImage.init(named: "Refresh")!, index: 1)
        t2.titleLabel?.font = tabFont
        t2.titleLabel?.textColor = UIColor.black
        t2.setHHTabBackgroundColor(color: defaultTabColor, forState: .normal)
        t2.setHHTabBackgroundColor(color: selectedTabColor, forState: .selected)
        
        //Note: As HHTabButton are subclassed of UIButton so you can modify it as much as possible.
        
        //Set Custom Tabs
        hhTabBarView.tabBarTabs = [t1, t2]
        
        //Set Default Index for HHTabBarView.
        hhTabBarView.defaultIndex = 1
        
        //Show Animation on Switching Tabs
        hhTabBarView.tabChangeAnimationType = .none
        
        //Handle Tab Change Event
        hhTabBarView.onTabTapped = { (tabIndex) in
            print("Selected Tab Index:\(tabIndex)")
        }
    }
  1. Setup window of your application inside the πŸ“Œ
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
        //Setup HHTabBarView
        setupReferenceUITabBarController()
        setupHHTabBarView()
        
        //Setup Application Window
        self.window = UIWindow.init(frame: UIScreen.main.bounds)
        self.window?.rootViewController = self.referenceTabBarController
        self.window?.makeKeyAndVisible()
        
        return true
    }
  1. Done! βœ…

ToDo[s]

  • Update README with multiple example usage and screenshots.

You can watch to HHTabBarView to see continuous updates. Stay tuned.

Have an idea for improvements of this class? Please open an issue. Β  Β 

Credits

Hemang Shah

You can shoot me an email to contact. Β 

Thank You!!

See the contributions for details.

License

The MIT License (MIT)

Read the LICENSE file for details.