NSVAnimatedTabBar

Example

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

Requirements

Swift 5.0

Installation

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

pod 'NSVAnimatedTabBar'

About

NSVAnimatedTabBar is fully customizable animated tab bar where center item can be used for more options to show.

Usage

NSVAnimatedTabBar constructed on 5 protocols, so you will need to create corresponding realization of that protocols to be able to use animated tab bar. You can customize almost everything.

Confirm to NSVAnimatedTabControllerDelegate to get each tab or center item sub option selection.

NSVAnimatedTabOptions

Main protocol to provide all all neccesary information.

tabHeight: CGFloat Height for tab bar

tabInsets: UIEdgeInsets Insets for tab bar

tabBackgroundColor: UIColor Tab bar background color

selectedItemColor: UIColor Tab bar selected item color

unselectedItemColor: UIColor Tab bar unselected item color

cornerRadius: CGFloat Tab bar corner radius

corners: [RadiusCorners] Tab bar curved corners

unselectedItemColor Tab bar unselected item color

shadowInfo: ShadowInfo Set this to have a shadow on top of tab bar

options: [NSVTabItemOptions] Array of tab bar items

animationOptions: NSVTabAnimationOptions Animation options of tab bar

centerItemOptions: NSVCenterItemOptions Option for tab bar's center item

coverAlpha: CGFloat Alpha value for cover view when center item is selected

mainBackgroundColor: UIColor? Background color for main view, will be visible for curved tab bar and if tabInsets is set to none zero. Set to nil if you want to automatically have a same color as selected view controller's view

NSVTabAnimationOptions

Animation protocol to provide main animation options.

mainAnimationDuration: Double Center item and tab bar animation duration

options: UIView.AnimationOptions Center item and tab bar animation options

usingSpringWithDamping: CGFloat Center item and tab bar animation spring and damping value

initialSpringVelocity: CGFloat Center item and tab bar animation initial spring velocity

delay: Double Center item and tab bar animation delay

tabMovePercentage: CGFloat? Tab bar change percentage based of it's height, set to 1 if you want to fully hide it, or nil, if you don't want an animation.

centerItemMovePercentage: CGFloat? Center item change percentage based of it's height, set nil, if you don't want an animation.

subOptionsAnimationtype: SubOptionsAnimationType Center item sub options animation type: .basic - first gif, just hides/shows all sub items at the same time. .fading - second gif, hides/shows one by one with changing each item alpha. .movingByOne - third gif, hides/shows one by one, with scaling, if needed.

tabSelectionAnimationType: TabSelectionAnimationType Each tab selection animation, used also to animate center item selection/deselection, can be none.

shouldAnimateScreenChanges: Bool Should animate selected view controller change.

NSVTabItemOptions

Tab bar each item options

title: String? Tab bar item title, set nil, if you want to have only image

image: UIImage? Tab bar item image, set nil, if you want to have only title

selectedImage: UIImage? Tab bar selected item image, if set to nil, it will use provided selectedItemColor(use template mode images, if you want to have color changes for an image)

itemInsets: UIEdgeInsets Tab bar item insets

spacing: CGFloat? Spacing between image and title

font: UIFont? Tab bar item title font

NSVCenterItemOptions

Center item options.

size: CGSize Center item size

subOptionsSize: CGSize Center item sub options size

insets: UIEdgeInsets Center item insets

options: NSVTabItemOptions Center item configuration option, similar to tab bar items.

subOptions: [NSCenterItemSubOptions] Array of center item's sub options

backgroundColor: UIColor Center item background color

cornerRadius: CGFloat Center item corner radius, set to size.width/2 to have rounded button

shadowInfo: ShadowInfo? Center item shadow

distributionType: SubOptionsDistributionType Center item sub options layout options For example .custom(itemsSpacing: 40, minYOffset: 50, maxYOffset: 50) itemsSpacing - spacing between items X axis minYOffset - minimal position for Y axis maxYOffset - maximal position for Y axis set minYOffset and maxYOffset to equal values, if you want to have sub options on the same line

curveType: CurveType Set to .bottom if you want to have a curve under center item

NSVCenterItemSubOptions

Center item sub options

image: UIImage Sub option image

backgroundColor: UIColor Sub option background color

cornerRadius: CGFloat Sub option corner radius

shadowInfo: ShadowInfo Sub option shadow

Check an example app, to see NSVAnimatedTabBar in usage.

What's next

Animations, Animations, Animations. I will try to add more animations for everything(item selection, sub option's appearance, etc...), add top curve option for center item, add option to open new screen instead of sub options, etc...

Author

Narek1994, [email protected]

https://www.linkedin.com/in/narek-simonyan-b3974b120/

License

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