hyperoslo / tabby

⛩ A fancy tabbar

Tabby

⚠️ DEPRECATED, NO LONGER MAINTAINED

// TODO: Add the image here.

Description

Tabby is the ultimate tab bar, a full substitution for those UITabBarControllers, UITabBars and UITabBarItems that are not customizable at all. Tabby has animations, behaviors and it has the easiness you would expect from any of our libraries.

Usage

Tabby begins with a controller, the called TabbyController. That one has an initializer taking TabbyBarItems. Each item has a controller, an image and an animation that defaults to a constant.

Once you have created the array of items, you can initialize the TabbyController like so:

let items = [
  TabbyBarItem(controller: firstController, image: UIImage(named: "first")),
  TabbyBarItem(controller: secondController, image: UIImage(named: "second"))
]

let controller = TabbyController(items: items)

Customization

As stated before, there are lots of customization points in Tabby, you can find the constants file with fonts, colors and animations.

A part from the typical constants, you'll be able to change the translucency, the indicator or the separator between the tab and the controller, with the possibility to add a shadow if you want.

controller.translucent = true
controller.showSeparator = false
controller.showIndicator = false
controller.barVisible = false

Behaviors

Tabby is built upon behaviors. As soon as we add more customization points within the source code, constants will emerge that will let you control more parts of the insights of Tabby. As for now, the first behavior dictates weather the title should be displayed, displayed only in the selected one, or not displayed at all.

To change that, you just set:

Tabby.Constant.Behavior.labelVisibility = .ActiveVisible

Animations

There are lots of default animations that you can use. We'll be adding more and more of those.

The default animations are:

Pop, Flip, Morph, Shake, Swing, PushUp, PushDown, None

Delegates

As for now, there is one delegate method that informs you which button was just pressed. This will let you rebuild the tab bar, reload it, add different items, etc.

func tabbyButtonDidPress(index: Int)

Be sure to check our demo if you have any further questions! :)

Installation

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

pod 'Tabby'

Tabby is also available through Carthage. To install just write into your Cartfile:

github "hyperoslo/Tabby"

Author

Made by Hyper Oslo. Contact us at [email protected].

Contributing

We would love you to contribute to Tabby, check the CONTRIBUTING file for more info.

License

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

tabby's Issues

Unable to find a specification for `Tabby`

hi

it seems like that this library cannot be found via CocoaPods

i add pod 'Tabby' inside my podfile, but i cannot find this awesome pod

Support badges in every tab.

Ability to refresh color settings

It would be nice and nifty to be able to invoke a reconfigure method to refresh the colors that are used in Tabby. Lets say that you application gets information from a backend about which colors to use in the Tabby, then if the color changes on the backend, you could apply this colors to the TabbyController without having to reinitialize a new TabbyController or recreate the items that are in the tab bar.

Unable to install using pod

Hello @zenangst ,

I am unable to install this library while using Pod.
It is giving the error [!] No podspec found for Tabby in ../../ Kindly find the attached screenshot.

use_frameworks!

platform :ios, '9.0'

target 'Tabbar Demo' do
  pod 'Tabby'
end

Can you please help me?

Feature intercepting tab bar selections

I think it could be useful to be able to intercept a navigation before it happens. Play with the idea that you have an item in your tab bar that actually leaves the application, then you don't want that to switch out the controller and to show and empty one when you get back into your application.

We can use Facebook and Facebook Messenger as an example, if you tap that item, you don't navigate inside Facebook, you are transported to Messenger. When you come back to Facebook, it is exactly like you left it.

I don't think this would be to hard to achieve if we change the delegate method on TabbyController to return a boolean value. If it is set to true, it would change, if false, then it is up to the developer to decide what is suppose to happen when a user taps the item.

So instead of this;
https://github.com/hyperoslo/Tabby/blob/master/Sources/TabbyController.swift#L8

func tabbyDidPress(item: TabbyBarItem)

You would have something like this;

func tabbyDidPress(item: TabbyBarItem) -> Bool

Add a convenience initializer to add controllers

It would be nice to be able to add the controllers directly in the init method.

TabbyController(controllers: [...])