https://github.com/jhurray/baloadinganimations

A wrapper over loading animations that makes it simple to incorporate into your project. Supports multiple animations and makes it easy to create/add new ones.
https://github.com/jhurray/baloadinganimations

Last synced: 17 days ago
JSON representation

A wrapper over loading animations that makes it simple to incorporate into your project. Supports multiple animations and makes it easy to create/add new ones.

• Host: GitHub
• URL: https://github.com/jhurray/baloadinganimations
• Owner: jhurray
• Created: 2014-07-21T16:15:57.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-12-11T00:15:00.000Z (about 10 years ago)
• Last Synced: 2023-08-09T08:44:01.117Z (over 1 year ago)
• Language: Objective-C
• Size: 250 KB
• Stars: 3
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
BALoadingAnimations

======

**An animated wrapper around asynchronous operations.**

Performs code in blocks asynchronously while presenting a loading animation.

When the work is done, the loading animation is removed from the view.

Styling / Configuration

--------------

Many loading animations:

* Spinner (Default)

* Ripple

* Wave

* Pulse

* Warp  

BALoadingAnimationConfig class methods change a singleton, which is used as the default configuration for all BALoadingAnimations.

Use BALoadingAnimationConfig the class methods to style the loading animations.

**OR...**

Create your own and pass it into a BALoadingAnimation class method if you want it to be different than your own default.

Basic Use

-----------

Add outside an async call and remove after that operation is completed.

**Never wrap these animations around operations on the main thread. This may cause animations to be delayed**

    [BALoadingAnimation addBALoadingAnimation:BALoadingAnimationTypeDefault toView:self.view];

         dispatch_async(dispatch_get_global_queue( DISPATCH_QUEUE_PRIORITY_LOW, 0), ^{

     

           [self makeBigRequestWithURL:url];

     

            dispatch_async(dispatch_get_main_queue(), ^{

                [self removeBALoadingAnimationFromView:self.view];

     

            });

         });

** Or, if a function already is async and has a callback ** just use the add and remove functionality like in the example below:

    NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init];

    [request setHTTPMethod:@"GET"];

    [request setURL:[NSURL URLWithString:url]];

    __weak id weakSelf = self;

    

    [BALoadingAnimation addBALoadingAnimation:BALoadingAnimationTypeDefault toView:self.view];

    

    [NSURLConnection sendAsynchronousRequest:request queue:nil completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {

        

        [BALoadingAnimationConfig setMessage:@"handling response..."];

        id stuff = [weakSelf doSomethingWithResponse:response];

        [weakSelf doMoreWithStuff:stuff];

        [BALoadingAnimation removeBALoadingAnimationFromView:(UIView *)superView];

    }];

Blocks

--------

Any code placed in a BAExecutionBlock will be run asynchronously and wrapped in a BALoadinganimation that is removed before completion block is called. 

    __block NSString *results = @"";

    

    [BALoadingAnimation runBALoadingAnimation:BALoadingAnimationTypeDefault onView:self.view whileExecuting:^{

        results = [self makeBigRequestWithURL:url];

    } withCompletion:^{

        NSLog(@"%@", results);

    }];

Custom Loading Animations

----------------

To create your own Custom loading animations subclass BAAnimationView and add a BALoadingAnimationType in the BALoadingAnimation.h file. Then update   

**+(CGRect)frameForAnimationType:(BALoadingAnimationType)animationType**   

and    

**+(BAAnimationView *)animationViewForAnimationType:(BALoadingAnimationType)animationType**   

appropriately in BALoadingAnimation.m.