The flextabbar from wonderkiln

flextabbar's Introduction

Flexible Tab Bar is a custom approach to the tab bar that allows you to create different views for different orientations/devices or states. iOS default UITabBar is limited and it is really hard to customize it for different device states.

Preview

Portrait (with a different type of button in the middle and different presentation when tapped)
Landscape (same tab layout as for the portrait one)

And for iPad:

Portrait (the middle button is now placed at the end and has the same presentation style as the rest of the tab pages)
Landscape (same tab layout as for the portrait one but now it displays the tab item title since it has more space to expand)

Adding to your project

To add open-tab-bar via CocoaPods into your project just create a Podfile and add this line:

pod 'open-tab-bar'

Install the pod by running pod install

Usage

1. Extending the controller

First extend your view controller from WKTabBarController:

class ViewController: WKTabBarController {

}

2. Setting the items

You can set the items in the viewDidLoad function via the tabBarItems property:

tabBarItems = [
  WKTabBarItem(title       : TAB_ITEM_TITLE,
               image       : NORMAL_IMAGE,
               highlighted : HIGHLIGHTED_IMAGE, (OPTIONAL)
               selected    : SELECTED_IMAGE     (OPTIONAL)
  )
]

3. Customizing the items

WKTabBarController already implements the WKTabBarControllerProtocol, so in your ViewController you can override these methods in order to customize the appearance of the items:

func tabBarController(_ controller: WKTabBarController, cellNameAtIndex index: Int) -> WKTabBarCellName
func tabBarController(_ controller: WKTabBarController, customize cell: WKBaseTabBarCell, with item: WKTabBarItem, at index: Int)

The line below allows you to return the view controller that you want to be shown. If you decide you want to do something that doesn't implies showing a controller just do you thing and then return nil.

func tabBarController(_ controller: WKTabBarController, viewControllerAtIndex index: Int) -> UIViewController?

4. Customizing the tab bar item

Create a class that extends the WKBaseTabBarCell class:

final class CustomTabBarItem: WKBaseTabBarCell {

}

In this class you can override these methods in order to customize the appearance of the item:

open func set(model: WKTabBarItem) // called when setting the tab bar model
open func commonInit()             // called when initialized
open func set(highlighted: Bool)   // called when the item should change its appearance on highlighted
open func set(selected: Bool)      // called when the item should change its appearance on selected

After this don't forget to register the new class with this line:

self.register(cell: CustomTabBarItem.self, withName: "CustomTabBarItem")

And you can now return the custom cell to be displayed:

func tabBarController(_ controller: WKTabBarController, cellNameAtIndex index: Int) -> WKTabBarCellName {
  return "CustomTabBarItem"
}

Credits

Adrian Mateoaea

License

flextabbar's People

Contributors

Stargazers

Watchers

flextabbar's Issues

Double invocation of commonInit()

We are seeing cases of a double awakeFromNib() invocation of the WKTabBarController instance.
This causes a duplication of the container view, which in turn, might causes problems if you are relying on a particular view hierarchy for additional customisation.

There is a particular setup that might help reproducing this.
We have two segues that point to a WKTabBarController subclass on storyboards.
One storyboard contains the definition of the Scene and another storyboard uses a Storyboard Reference to execute a segue to that scene. The latter is the one that seems to trigger this double invocation.

A proposed fix is to introduce a nil check at the top of commonInit():

func commonInit() {
    if(container != nil){
        return
    }
    container = UIView()
    ...
}

pod does not exist

Hi wonderkiln Team,

I found 'WKAwesomeMenu' but 'open-tab-bar' does not exist.

Thanks
Sebastian

two Error in WKTabBarController.swift swift 4

error in WKTabBarController.swift

1- Error
Argument of '#selector' refers to instance method 'didChangeOrientation' that is not exposed to Objective-C

NotificationCenter.default.addObserver( self, selector: #selector(didChangeOrientation(_:)), name: NSNotification.Name.UIApplicationDidChangeStatusBarOrientation, object: nil) if let vc = tabBarController(self, viewControllerAtIndex: 0) { changeViewController(vc) }
error:
selector: #selector(didChangeOrientation(_:)),

and

2- Error
Contextual closure type '(_, WKTabBarItem) -> _' expects 2 arguments, but 1 was used in closure body

open func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize { let proportion = tabBarItems[indexPath.row].proportion let sum = tabBarItems.reduce(0.0) { $0.0 + $0.1.proportion } return CGSize(width: collectionView.bounds.width * CGFloat(proportion / sum), height: collectionView.bounds.height) }

error :
let sum = tabBarItems.reduce(0.0) { $0.0 + $0.1.proportion }

Recommend Projects

wonderkiln / flextabbar Goto Github PK