NVActivityIndicatorView

Introduction

NVActivityIndicatorView is a collection of nice loading animations.

This is original a fork from DGActivityIndicatorView, inspired by Loaders.css, written in Swift with full implementation of animations.

You can also find Objective-C version of this here.

Demo

For first-hand experience, just open the project and run it.

Animation types

BallPulse
BallGridPulse
BallClipRotate
SquareSpin
BallClipRotatePulse
BallClipRotateMultiple
BallPulseRise
BallRotate
CubeTransition
BallZigZag
BallZigZagDeflect
BallTrianglePath
BallScale
LineScale
LineScaleParty
BallScaleMultiple
BallPulseSync
BallBeat
LineScalePulseOut
LineScalePulseOutRapid
BallScaleRipple
BallScaleRippleMultiple
BallSpinFadeLoader
LineSpinFadeLoader
TriangleSkewSpin
Pacman
BallGridBeat
SemiCircleSpin
BallRotateChase
Orbit
AudioEqualizer

Installation

Cocoapods

Install Cocoapods if need be

$ gem install cocoapods

Add NVActivityIndicatorView in your Podfile

use_frameworks!

pod 'NVActivityIndicatorView'

Then, run the following command

$ pod install

Carthage

Install Carthage if need be

$ brew update
$ brew install carthage

Add NVActivityIndicatorView in your Cartfile

github "ninjaprox/NVActivityIndicatorView"

Run carthage to build the framework and drag the built NVActivityIndicatorView.framework into your Xcode project.

Manual

Copy NVActivityIndicatorView folder to your project. That's it.

Usage

Firstly, import NVActivityIndicatorView

import NVActivityIndicatorView

Initialization

Then, there are multiple ways you can create NVActivityIndicatorView:

Use it in storyboard by changing class of any UIView to NVActivityIndicatorView This will use default values white, .BallSpinFadeLoader, 0 for color, type and padding respectively.
Create with specified type, color and padding

NVActivityIndicatorView(frame: frame, type: type, color: color, padding: padding)

Any of the last three arguments can be omitted. If an argument is omitted it will use the default values which are white, .BallSpinFadeLoader, 0 for color, type and padding respectively. Therefore, you can also create NVActivityIndicatorView using any of the following:

Specify only frame, type and color

NVActivityIndicatorView(frame: frame, type: type, color: color)

Specify only frame, type and padding

NVActivityIndicatorView(frame: frame, type: type, padding: padding)

Specify only frame, color and padding

NVActivityIndicatorView(frame: frame, color: color, padding: padding)

Specify only frame and type

NVActivityIndicatorView(frame: frame, type: type)

Specify only frame and color

NVActivityIndicatorView(frame: frame, color: color)

Specify only frame and padding

NVActivityIndicatorView(frame: frame, padding: padding)

Specify only frame

NVActivityIndicatorView(frame: frame)

Start/Stop animation

Start animation

activityIndicatorView.startAnimation()

Stop animation

activityIndicatorView.stopAnimation()

UI blocker

You can use NVActivityIndicatorView as UI blocker for UIViewController by conforming NVActivityIndicatorViewable protocol.

class ViewController: UIViewController, NVActivityIndicatorViewable { }

Start animation

startActivityAnimating(size, message) // plus other parameters as when initializing

Stop animation

stopActivityAnimating()

Change properties

If you use NVActivityIndicatorView in storyboard, you can change these properties in Attributes inspector tab of Utilities panel.

Use one of values (case-insensitive) in Animation types for Type Name.

Specify individual properties after initialization:

Specify type

activityIndicatorView.type = .LineScale

Specify color

activityIndicatorView.color = UIColor.redColor()

Specify whether activity indicator view should hide once stopped

activityIndicatorView.hidesWhenStopped = true

Get current status of animation

animation = activityIndicatorView.animating

Change defaults

Change global defaults if needed

NVActivityIndicatorView.DEFAULT_TYPE = .Pacman
NVActivityIndicatorView.DEFAULT_COLOR = UIColor.yellowColor()
NVActivityIndicatorView.DEFAULT_PADDING = CGFloat(5.0)
NVActivityIndicatorView.DEFAULT_BLOCKER_SIZE = CGSizeMake(60, 60)

Acknowledgment

Thanks Connor Atherton for great loaders and Danil Gontovnik for kick-start.

License

The MIT License (MIT)

davidvypark/NVActivityIndicatorView