Table of Contents

• AAViewAnimator
  • Description
  • Demonstration
  • Requirements
• Installation
  • CocoaPods
  • Carthage
  • Manual Installation
• Getting Started
  • Animate your view!
  • Apply transition on your view!
  • Animation types
  • Transition types
• Contributions & License

#AAViewAnimator

##Description

AAViewAnimator is a simple, lightweight & easy-to-use rating bar designed to get and set ratings in iOS, written in Swift. It is a customised storyboard based UIView class that allows to customise in the UIStoryboard without writing code.

##Demonstration

AAViewAnimator is a collection of animations and transitions for UIView designed to apply animations on every UIView with options in iOS, written in Swift. It allows various options for animations and parameters to make them unique!

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

##Requirements

• iOS 8.0+
• Xcode 8.0+
• Swift 3+

Installation

AAViewAnimator can be installed using CocoaPods, Carthage, or manually.

##CocoaPods

AAViewAnimator is available through CocoaPods. To install CocoaPods, run:

$ gem install cocoapods

Then create a Podfile with the following contents:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target '<Your Target Name>' do
pod 'AAViewAnimator', '1.0'
end

Finally, run the following command to install it:

$ pod install

##Carthage

To install Carthage, run (using Homebrew):

$ brew update
$ brew install carthage

Then add the following line to your Cartfile:

github "EngrAhsanAli/AAViewAnimator" "master"

Then import the library in all files where you use it:

import AAViewAnimator

##Manual Installation

If you prefer not to use either of the above mentioned dependency managers, you can integrate AAViewAnimator into your project manually by adding the files contained in the Classes folder to your project.

#Getting Started

##Animate your view!

You can simply animate your view just by calling aa_animate function with animation option

Usage:

yourView.aa_animate(duration: 0.5, animation: .scale(rate: 1.2))

##Apply transition on your view!

You can simply apply transition your view just by calling aa_animate function with animation option

Usage:

yourView.aa_animate(duration: 1.2, springDamping: .slight, animation: animator) { inAnimating, animView in
if inAnimating {
// View is animating
}
else {
// View's animation is done
}
}

Note that the function signature for animation is: swift func aa_animate(duration: TimeInterval, springDamping: AAViewDamping, animation: AAViewAnimators, completion: ((_ isAnimating: Bool)->())? = nil)

##Animation types

AAViewAnimators	Description
scale(rate:Float)	Animation with scale effect
vibrateX(rate:CGFloat)	Animation with vibrate at x axis effect
vibrateY(rate:CGFloat)	Animation with vibrate at y axis effect
rotateLeft	Animation with left rotation effect
rotateRight	Animation with right rotation effect
rotateRound	Animation with round rotation effect
zoomIn	Animation with zoom in effect
zoomOut	Animation with zoom out effect

##Transition types

You can use following animation transition:

AAViewAnimators	Description
fromTop	Transition from Top (View will be visible)
fromBottom	Transition from Bottom (View will be visible)
fromLeft	Transition from Left (View will be visible)
fromRight	Transition from Right (View will be visible)
fromFade	Transition with Fade (View will be visible)
toTop	Transition to Top (View will not be visible)
toBottom	Transition to Bottom (View will not be visible)
toLeft	Transition to Left (View will not be visible)
toRight	Transition to Right (View will not be visible)
toFade	Transition with Fade (View will not be visible)

#Contributions & License

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

Pull requests are welcome! The best contributions will consist of substitutions or configurations for classes/methods known to block the main thread during a typical app lifecycle.

I would love to know if you are using AAViewAnimator in your app, send an email to Engr. Ahsan Ali