animated-tab-bar README

The project's README from github.com/Ramotion/animated-tab-bar. As one markdown file: README.md.

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:


CocoaPods CocoaPods Carthage compatible Swift 4.0 Twitter Travis Donate

Requirements

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

  1. Create a new UITabBarController in your storyboard or nib.

  2. Set the class of the UITabBarController to RAMAnimatedTabBarController in your Storyboard or nib.

  3. For each UITabBarItem, set the class to RAMAnimatedTabBarItem.

  4. Add a custom image icon for each RAMAnimatedTabBarItem

  5. 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

  1. Create a new class which inherits from RAMItemAnimation:
   class NewAnimation : RAMItemAnimation
  1. 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  
  }
  1. 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.



animated-tab-bar (Ramotion/animated-tab-bar)

Searching Database…

11.1K ·GitHub
Animated-tab-bar
Что это такое?RAMAnimatedTabBarController — библиотека-модуль на Swift, которая добавляет анимацию к элементам и иконкам панели вкладок iOS.
Это отдельное приложение или библиотека, которую я добавляю в свой проект?Это библиотека, которую добавляют в существующий проект iOS. Она предоставляет собственный подкласс UITabBarController, а не отдельное приложение.
Как добавить её в свой проект?Добавьте папку RAMAnimatedTabBarController прямо в проект или установите библиотеку через CocoaPods, Carthage или Swift Package Manager.
Что нужно, прежде чем начать использовать её?Нужен Xcode 10.2 и проект, рассчитанный на iOS 9.0 или новее.
Как настроить её в Storyboard?Задайте классу вашего UITabBarController значение RAMAnimatedTabBarController, задайте каждому UITabBarItem класс RAMAnimatedTabBarItem, добавьте свою иконку, затем перетащите NSObject в контроллер вида, назначьте ему класс выбранной анимации и подключите его как аутлет.
Работает ли это за пределами iOS, например в приложениях для macOS?Нет, она создана специально для панелей вкладок iOS (UIKit), а не как кроссплатформенная библиотека UI.
Какие анимации есть в комплекте?В комплекте девять готовых анимаций элементов, например RAMBounceAnimation, RAMLeftRotationAnimation, RAMRightRotationAnimation, переходы с переворотом по направлению (влево/вправо/вверх/вниз), RAMFrameItemAnimation и RAMFumeAnimation.
Могу ли я создать свою анимацию?Да, нужно создать класс, наследующий от RAMItemAnimation, и реализовать методы, описанные в 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 20Release5.1.0Nov 05
Age
11y
Commits · 90 Days