Package - daltoniam/Jazz

jazz

Jazz is an view animation library in Swift for iOS. It provides custom controls that can provide easy animations.

Features

  • Animatable controls
  • Button View
  • LoadingView/ProgressView
  • Shape View
  • Simple concise codebase at just a few hundred LOC.

Example

First thing is to import the framework. See the Installation instructions on how to add the framework to your project.

import Jazz

See the examples directory for pretty example projects.

The code:

//Shape is a view in a view controller

//add a shape view to the view controller 
let shape = ShapeView(layout: ShapePath(frame: CGRectMake(10, 80, 250, 50), corners: .AllCorners, cornerRadius: 25, borderWidth: 0))
shape.color = UIColor(red: 253/255.0, green: 56/255.0, blue: 105/255.0, alpha: 1)
shape.autoresizingMask = .FlexibleHeight | .FlexibleWidth
self.view.addSubview(shape)

//play those animations!
Jazz(0.25, animations: {
    let width: CGFloat = 300
    self.shape.layout = ShapePath(frame: CGRectMake((self.view.frame.size.width-width)/2, corners: .AllCorners, cornerRadius: 25, borderWidth: 3)
    self.shape.borderColor = UIColor.orangeColor()
    self.shape.color = UIColor.redColor()
}).delay(2).play(0.25, animations: {
    let width: CGFloat = 100
    self.shape.frame = CGRectMake((self.view.frame.size.width-width)/2, 80, width, 50)
    self.shape.color = UIColor.purpleColor()
}).delay(4).play(0.25, animations: {
    self.shape.layout = ShapePath(frame: CGRectMake(10, 80, 250, 100), corners: .AllCorners, cornerRadius: 0, borderWidth: 0)
    self.shape.borderColor = nil
    self.shape.color = UIColor.yellowColor()
}).delay(2).play(0.25, animations: {
    self.shape.layout = ShapePath(frame: CGRectMake(10, 80, 100, 100), corners: .AllCorners, cornerRadius: 50, borderWidth: 0)
    self.shape.frame = CGRectMake(10, 80, 100, 100)
    self.shape.color = UIColor.blueColor()
})

Requirements

Jazz works with iOS 7 or above. It is recommended to use iOS 8/10.10 or above for CocoaPods/framework support.

Installation

CocoaPods

Check out Get Started tab on cocoapods.org.

To use Jazz in your project add the following 'Podfile' to your project

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

pod 'Jazz', '~> 1.0.0'

Then run:

pod install

Carthage

Check out the Carthage docs on how to add a install. The Jazz framework is already setup with shared schemes.

Carthage Install

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Jazz into your Xcode project using Carthage, specify it in your Cartfile:

github "daltoniam/Jazz" >= 1.0.0

Rogue

First see the installation docs for how to install Rogue.

To install Jazz run the command below in the directory you created the rogue file.

rogue add https://github.com/daltoniam/jazz

Next open the libs folder and add the Jazz.xcodeproj to your Xcode project. Once that is complete, in your "Build Phases" add the Jazz.framework to your "Link Binary with Libraries" phase. Make sure to add the libs folder to your .gitignore file.

Other

Simply grab the framework (either via git submodule or another package manager).

Add the Jazz.xcodeproj to your Xcode project. Once that is complete, in your "Build Phases" add the Jazz.framework to your "Link Binary with Libraries" phase.

Add Copy Frameworks Phase

If you are running this in on a physical iOS device you will need to make sure you add the Jazz.framework to be included in your app bundle. To do this, in Xcode, navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar. In the tab bar at the top of that window, open the "Build Phases" panel. Expand the "Link Binary with Libraries" group, and add Jazz.framework. Click on the + button at the top left of the panel and select "New Copy Files Phase". Rename this new phase to "Copy Frameworks", set the "Destination" to "Frameworks", and add the Jazz.framework.

TODOs

  • [ ] Add extra convenience animation tools.
  • [ ] Add example project
  • [ ] Complete Docs
  • [ ] Add Unit Tests

License

Jazz is licensed under the Apache v2 License.

Contact

Dalton Cherry

  • https://github.com/daltoniam
  • http://twitter.com/daltoniam
  • http://daltoniam.com

Github

link
Stars: 25

Advertisement