bal

BALoadingView

A UIView that offers several loading animations

Showing:

Popularity

Downloads/wk

0

GitHub Stars

264

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

0

License

MIT

Categories

Readme

BALoadingView

Version License Platform

Overview

example1 example2

A UIView that offers several loading animations.


Requirements

  • Works on any iOS device

Example

To run the example project, clone the repo, and run pod install from the Example directory first.


Getting Started

Installation

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

pod "BALoadingView"

Simple Usage

startAnimation:

To add a BALoadingView to your app, add the line:

BALoadingView *view = [[BALoadingView alloc] initWithFrame:self.view.frame];
[self.loadingView initialize];
[self.loadingView startAnimation:BACircleAnimationFullCircle];
//OR [self.loadingView startAnimation:BACircleAnimationSemiCircle];

This creates the following animation/button by default:

example3a

Passing the BACircleAnimationSemiCircle enum produces:

example3b

stopAnimation

stopAnimation removes the animations from the view.

Advanced Usage

Listed below are examples of several properties that you can control.

Initialize

initialize sets the default values and should be called before setting any properties.

Duration

If you want the loading animation to last longer/shorter, you can edit the duration property:

BALoadingView *loadingView = [[BALoadingView alloc] initWithFrame:self.view.frame];
[self.loadingView initialize];
self.loadingView.duration = 20.0f;
self.loadingView.segmentColor = [UIColor whiteColor];
[self.loadingView startAnimation:BACircleAnimationFullCircle];

This creates this view:

example4

Clockwise

Editting the clockwise boolean property changes the direction of the full circle animation:

BALoadingView *loadingView = [[BALoadingView alloc] initWithFrame:self.view.frame];
[self.loadingView initialize];
self.loadingView.clockwise = YES;
self.loadingView.segmentColor = [UIColor whiteColor];
[self.loadingView startAnimation:BACircleAnimationFullCircle];

This creates this view:

example5

Segment Color

the segmentColorproperty controls the color of the segments and can be used like like in the example above

Line Cap

the lineCapproperty controls the end caps for the semi circle animation. The rouded cap option is seen below:

[self.loadingView initialize];
self.loadingView.lineCap = kCALineCapRound;
self.loadingView.clockwise = true;
self.loadingView.segmentColor = [UIColor whiteColor];
[self.loadingView startAnimation:BACircleAnimationFullCircle];

The animation looks like this:

example6

Author

Bryan Antigua, antigua.B@gmail.com - bryanantigua.com

License

BALoadingView 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