Home Original page

GitHub - Henryforce/KRActivityIndicatorView: An activity indicator view for OSX written in Swift!

Carthage Compatible MIT licensed

Introduction

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

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" >= 1.0.5

If you are using Swift 3, add KRActivityIndicatorView in your Cartfile like this:

github "henryforce/KRActivityIndicatorView" == 1.0.4

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