cir

CircularSpinner

A Beautiful fullscreen Circular Spinner, very useful for determinate and indeterminate task. You can use it as activity indicator during loading.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

72

Maintenance

Last Commit

3yrs ago

Contributors

4

Package

Dependencies

0

License

MIT

Categories

Readme

CircularSpinner

A Beautiful fullscreen Circular Spinner, very useful for determinate or indeterminate task. You can use it as activity indicator during loading.

Demo

Spinner demo

Installation

CircularSpinner is available through CocoaPods. To install it, simply add the following line to your Podfile:

Swift 3:

pod 'CircularSpinner'

Swift 2.2:

pod 'CircularSpinner' ', '~> 0.2'

Objective-C:

use_frameworks!
pod 'CircularSpinner' , '~> 1.2.0'

Link the 'CircularSpinner.framework' to your target in Build Phases.

Usage

You can present the circular spinner from anywhere by calling the show() class method.

The default presentation mode is fullscreen, if you want present the spinner in a custom container view use this code before presenting it:

CircularSpinner.useContainerView(containerView)

Determinate Mode Example:

Presentation:

CircularSpinner.show(animated: true, showDismissButton: false, delegate: self)

Update the value by calling:

CircularSpinner.setValue(0.2, animated: true)

The spinner will automatically dismiss when it reaches the 100%, alternatively you can dismiss it manually by calling:

CircularSpinner.hide()

Indeterminate Mode Example:

Presentation:

CircularSpinner.show("Loading...", animated: true, type: .indeterminate)

Dismiss by calling:

CircularSpinner.hide()

Usage (example in Objective-C)

You can present the circular spinner from anywhere by calling the show() class method.

#import "ViewController.h"
#import <CircularSpinner/CircularSpinner-Swift.h>

@interface ViewController () <CircularSpinnerDelegate>

@end

@implementation ViewController

- (void)viewDidLoad {
[super viewDidLoad];
}

- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
[CircularSpinner show:@"Loading" animated: TRUE type:CircularSpinnerTypeDeterminate showDismissButton:[NSNumber numberWithBool:TRUE] delegate:self];
[CircularSpinner setValue:0.1 animated: TRUE];
}
@end

Delegate

There's one method in the CircularSpinnerDelegate that you can use to customize the appearance of the percentual Label:

@objc optional func circularSpinnerTitleForValue(_ value: Float) -> NSAttributedString

Author

taglia3, matteo.tagliafico@gmail.com

LinkedIn, Matteo Tagliafico

License

CircularSpinner is available under the MIT license. See the LICENSE file for more info.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial