carabina / livetabbar

Animated tab bar items and badges for iOS apps

LiveTabBar

Example

To run the example project, clone the repo, and run pod install from the Example directory first. Alternatively, run pod try LiveTabBar from the terminal.

Name	Tab Bar Demo	Badge Demo
Spring
Bounce
Wobble
Spin

About

LiveTabBar is an easy way to spruce up tabbed iOS applications. It offers a simple interface built on top of UIKit for animating tab bar items and item badges. The library uses Core Animation (CAAnimation) and provides a set of default animations, but you can create your own so long as they conform to CAAnimation.

This library was made for subtle tab bar enhancements. If you are looking for complete flexibility, check out ESTabBarController which implements a custom tab bar system.

Usage

Tab Controller

Use LiveTabBarController in place of UITabBarController, supplying a tab animation. It subclasses UITabBarController and the interface has not been restricted or modified. From there, add your tabs and controllers as normal!

let tabController = LiveTabBarController(tabItemAnimation: DefaultAnimation.spin)
tabController.viewControllers = [...

self.window?.rootViewController = UINavigationController(rootViewController: tabController)

Badges

For a simpler interface, the live badges are implemented as an extension to UITabBarController and can be presented & dismissed without redundant casting. For example:

self.tabBarController?.setLiveBadge(tabPageIndex: 0, value: "1", backgroundColor: .red,
                                    animation: DefaultAnimation.wobble) // present
                                    
self.tabBarController?.dismissLiveBadge(tabPageIndex: self.tabPageIndex, fadeDuration: 0.25) // dismiss

Installation

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

pod 'LiveTabBar'

License

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