Skip to content

MartinLau7/KRActivityIndicatorView

 
 

Repository files navigation

KRActivityIndicatorView

Carthage Compatible MIT licensed

Introduction

KRActivityIndicatorView is a collection of awesome loading animations for OSX apps written in Swift 3.0.

This is a fork from NVActivityIndicatorView, which is made for iOS. Amazing code made by Vinh Nguyen!

The original code for the NVActivityIndicatorView is not 100% compatible with OSX. And the project has some amazing loaders, so I decided to port the code in order for it to work in OSX. Fortunately, KRActivityIndicatorView maintains most of the functionality and all the animations of the iOS counterpart.

Demo

alt tag

Animation types

Type Type Type Type
  1. BallPulse | 2. BallGridPulse | 3. BallClipRotate | 4. SquareSpin
  2. BallClipRotatePulse | 6. BallClipRotateMultiple | 7. BallPulseRise | 8. BallRotate
  3. CubeTransition | 10. BallZigZag | 11. BallZigZagDeflect | 12. BallTrianglePath
  4. BallScale | 14. LineScale | 15. LineScaleParty | 16. BallScaleMultiple
  5. BallPulseSync | 18. BallBeat | 19. LineScalePulseOut | 20. LineScalePulseOutRapid
  6. BallScaleRipple | 22. BallScaleRippleMultiple | 23. BallSpinFadeLoader | 24. LineSpinFadeLoader
  7. TriangleSkewSpin | 26. Pacman | 27. BallGridBeat | 28. SemiCircleSpin
  8. BallRotateChase | 30. Orbit | 31. AudioEqualizer

Installation

Carthage

Install Carthage if need be.

$ brew update
$ brew install carthage

Add KRActivityIndicatorView in your Cartfile.

github "henryforce/KRActivityIndicatorView"

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

Manual

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

Note: Make sure that all files in KRActivityIndicatorView are included in Compile Sources in Build Phases.

Usage

Firstly, import KRActivityIndicatorView.

import KRActivityIndicatorView

Initialization

Then, there are two ways you can create KRActivityIndicatorView:

  • By storyboard, changing class of any NSView to KRActivityIndicatorView.

Note: Set Module to KRActivityIndicatorView.

  • By code, using initializer. All parameters other than frame are optional and KRActivityIndicatorView.DEFAULT_* are used as default values.
KRActivityIndicatorView(frame: frame, type: type, color: color, padding: padding)

Control

Start animating.

activityIndicatorView.startAnimating()

Stop animating.

activityIndicatorView.stopAnimating()

Determine if it is animating.

animating = activityIndicatorView.animating

Change properties

In storyboard, you can change all properties in Attributes inspector tab of Utilities panel.

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

All properties are public so you can change them all after initiating.

Note: All changes must be made before calling startAnimating().

Acknowledgment

Thanks to Connor Atherton for designing the loaders and Danil Gontovnik and Vinh Nguyen for the base code.

License

The MIT License (MIT)

2017 Henry Serrano @HenrySerrano20

About

An activity indicator view for OSX written in Swift!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 98.9%
  • Objective-C 1.1%