animated-tab-bar README

ANIMATED TAB BAR

Swift UI module library for adding animation to iOS tabbar items and icons.

We specialize in the designing and coding of custom UI for Mobile Apps and Websites.

Stay tuned for the latest updates:

Requirements

iOS 9.0+
Xcode 10.2

Installation

Just add the RAMAnimatedTabBarController folder to your project.

or use CocoaPods with Podfile:

pod 'RAMAnimatedTabBarController'

or Carthage users can simply add to their Cartfile:

github "Ramotion/animated-tab-bar"

or Swift Package Manager

Usage

Create a new UITabBarController in your storyboard or nib.
Set the class of the UITabBarController to RAMAnimatedTabBarController in your Storyboard or nib.
For each UITabBarItem, set the class to RAMAnimatedTabBarItem.
Add a custom image icon for each RAMAnimatedTabBarItem
Add animation for each RAMAnimatedTabBarItem :
- drag and drop an NSObject item into your ViewController
- set its class to ANIMATION_CLASS (where ANIMATION_CLASS is the class name of the animation you want to use)
- connect the outlet animation in RAMAnimatedTabBarItem to your ANIMATION_CLASS Demonstration video for step 5

Included Animations

Creating Custom Animations

Create a new class which inherits from RAMItemAnimation:

   class NewAnimation : RAMItemAnimation

Implement the methods in RAMItemAnimationProtocol:

  // method call when Tab Bar Item is selected
  override func playAnimation(icon: UIImageView, textLabel: UILabel) {
    // add animation
  }

  // method call when Tab Bar Item is deselected
  override func deselectAnimation(icon: UIImageView, textLabel: UILabel, defaultTextColor: UIColor, defaultIconColor: UIColor) {
    // add animation
  }

  // method call when TabBarController did load
  override func selectedState(icon: UIImageView, textLabel: UILabel) {
    // set selected state  
  }

Example:

import RAMAnimatedTabBarController

class RAMBounceAnimation : RAMItemAnimation {

    override func playAnimation(_ icon: UIImageView, textLabel: UILabel) {
        playBounceAnimation(icon)
        textLabel.textColor = textSelectedColor
    }

    override func deselectAnimation(_ icon: UIImageView, textLabel: UILabel, defaultTextColor: UIColor, defaultIconColor: UIColor) {
        textLabel.textColor = defaultTextColor
    }

    override func selectedState(_ icon: UIImageView, textLabel: UILabel) {
        textLabel.textColor = textSelectedColor
    }

    func playBounceAnimation(_ icon : UIImageView) {

        let bounceAnimation = CAKeyframeAnimation(keyPath: "transform.scale")
        bounceAnimation.values = [1.0 ,1.4, 0.9, 1.15, 0.95, 1.02, 1.0]
        bounceAnimation.duration = TimeInterval(duration)
        bounceAnimation.calculationMode = kCAAnimationCubic

        icon.layer.add(bounceAnimation, forKey: "bounceAnimation")
    }
}

📄 License

Animated Tab Bar is released under the MIT license. See LICENSE for details.

This library is a part of a selection of our best UI open-source projects.

If you use the open-source library in your project, please make sure to credit and backlink to www.ramotion.com

📱 Get the Showroom App for iOS to give it a try

Try this UI component and more like this in our iOS app. Contact us if interested.

11.1K ·GitHub

Animated-tab-bar

What is this?

RAMAnimatedTabBarController is a Swift UI module library that adds animation to iOS tab bar items and icons.

Is this a standalone app or a library I add to my project?

It is a library you drop into an existing iOS project; it provides a custom UITabBarController subclass, not a standalone app.

How do I add it to my project?

Add the RAMAnimatedTabBarController folder directly, or install it via CocoaPods, Carthage, or Swift Package Manager.

What do I need before using it?

You need Xcode 10.2 and a project targeting iOS 9.0 or later.

How do I wire it up in Storyboard?

You set your UITabBarController's class to RAMAnimatedTabBarController, set each UITabBarItem's class to RAMAnimatedTabBarItem, add a custom icon, then drag an NSObject into the view controller set to the chosen animation class and connect it as an outlet.

Does this work beyond iOS, like on macOS apps?

No, it's built specifically for iOS tab bars (UIKit), not a cross-platform UI library.

What animations come built in?

Nine preset item animations are included, such as RAMBounceAnimation, RAMLeftRotationAnimation, RAMRightRotationAnimation, the flip-direction transitions (left/right/top/bottom), RAMFrameItemAnimation, and RAMFumeAnimation.

Can I make my own custom animation?

Yes, you create a class that inherits from RAMItemAnimation and implements the methods defined in RAMItemAnimationProtocol.

What are similar projects?

Spring, SkeletonView, awesome-ios-ui, ChunUI, awesome-swift, SVProgressHUD, expo-backdrop, GestaltEdit

Which topics is it in?

swift-library, ui-design, ios-app, swiftui, material-design, apple, mobile-app, swift, ui-components, animation, customization, mobile

Creator: Ramotion
Size: 9.4 MB
Stars: 11.1K
Updated: CommitMay 20 Release5.1.0Nov 05
Age: 11y
Commits · 90 Days