Skip to content

matthewcheok/Fluent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

Fluent License MIT

Badge w/ Version Badge w/ Platform

Swift Animations made Easy

Installation

  • Add the following to your Podfile and run pod install
    pod 'Fluent', '~> 0.1'
  • or add the following to your Cartfile and run carthage update
    github "matthewcheok/Fluent"
  • or clone as a git submodule,

  • or just copy files in the Fluent folder into your project.

Using Fluent

Fluent makes writing animations declarative and chainable.

boxView
.animate(0.5)
.rotate(0.5)
.scale(2)
.backgroundColor(.blueColor())
.waitThenAnimate(0.5)
.scale(1)
.backgroundColor(.redColor())

Simply call one of the animation methods, of which only duration is required:

  • animate(duration: NSTimeInterval, velocity: CGFloat , damping: CGFloat, options: UIViewAnimationOptions)
  • waitThenAnimate(duration: NSTimeInterval, velocity: CGFloat , damping: CGFloat, options: UIViewAnimationOptions)

All common properties on UIView are supported:

  • scale(factor: CGFloat)
  • translate(x: CGFloat, y: CGFloat)
  • rotate(cycles: CGFloat)
  • backgroundColor(color: UIColor)
  • alpha(alpha: CGFloat)
  • frame(frame: CGRect)
  • bounds(bounds: CGRect)
  • center(center: CGPoint)

There are also relative versions of the transforms:

  • scaleBy(factor: CGFloat)
  • translateBy(x: CGFloat, y: CGFloat)
  • rotateBy(cycles: CGFloat)

You may not mix absolute and relative transformations in the same animation.

Using transforms

The order of the transformations are important!

To reverse the following:

boxView
.animate(1)
.translateBy(50, 50)
.rotateBy(0.5)
.scaleBy(2)
.backgroundColor(.blueColor())
.alpha(0.7)

We need to undo the transformations in reverse or get weird results:

boxView
.animate(1)
.scaleBy(0.5)
.rotateBy(-0.5)
.translateBy(-50, -50)
.backgroundColor(.redColor())

License

Fluent is under the MIT license.