Skip to content

MobileUpLLC/TabBarController

Repository files navigation

TabBarController


Fully customizable tabbar controller.

Features

  • Cusom tabbar view. No limitations.
  • Standart UIViewController lifecycle for child controllers.
  • Preserve child controllers across selection.
  • Hide/Show tabbar view.
  • Cocoa-like API. UIKit support.

Usage

  1. Create custom tabbar view
class MyTabBarView: UIView { 
    // Should be called on every selected tab change.
    var onItemSelect: (Int) -> Void

    // Current selected tab index.
    var selectedIndex: Int

    // Layout tab bar view items.
}

Note: Above provided one of possible API. You are not limited to use delegate or other patterns.

  1. Create custom tabbar controller
import TabBarController

class MyTabBarController: TabBarController {
    // Provide your root controllers.
    override var controllers: [UIViewController] { myChildControllers }

    // Provide your tabbar view.
    override var tabBarView: UIView { myTabBarView }
    
    override func viewDidLoad() {
        super.viewDidLoad()

        view.addSubview(myTabBarView)
        // Add contraints for tabbar view or layout it other way.

        // Show corresponding child controller on tabbar view selection change.
        myTabBarView.onItemSelect = { [weak self] selectedIndex in
            self?.selectedIndex = seelctedIndex
        }
    }

    // Update tabbar view state on programmatically selected tab chage.
    override func selectedIndexDidChange() {
        super.selectedIndexDidChange()

        myTabBarView.selectedIndex = selectedIndex
    }
}
  1. Use MyTabBarController as default tabbar controller.
let controller = MyTabBarController()
controller.myChildControllers = [...]

window?.rootViewContoller = controller
  1. (Optional, but handy) To make MyTabBarContoller accessible from every UIViewController just like default UITabBarController:
extension UIViewController {
    var myTabBarController: MyTabBarController? {
        findParent(type: MyTabBarController.self)
    }
}

So from any view controller:

myTabBarController.setTabBarVisibility(isHidden: true)

Implementation Details

The implementation is super lightweight. TabBarController inherits UIViewController and doesn't use UITabBarController under the hood.

Requirements

  • Swift 5.0
  • iOS 15.0

Installation

SPM

dependencies: [
    .package(
        url: "https://github.com/MobileUpLLC/TabBarController",
        .upToNextMajor(from: "1.0.0")
    )
]

License

TabBarController is destributed under the MIT license.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages