hatta-pivot / MBSimpleLoadingIndicator

An easy-to-use, highly-customizable loading indicator for iOS apps

MBSimpleLoadingIndicator

Code:

  //Create the loader
  _loadview = [[MBLoadingIndicator alloc] init];
    
  //Start the loader
  [self.loadview start];
    
  //Add the loader to our view
  [self.view addSubview:self.loadview];

Usage

###Change the percentage

//Change the percentage
[_loadview incrementPercentageBy:17];

//Fill up and start ending animation
[_loadview finish];

###Animated properties of the loader

//Change loader colors
[_loadview setLoadedColor:[UIColor darkGrayColor]];
[_loadview setBufferColor:[UIColor whiteColor]];

//Change loader sizes
[_loadview setWidth:15];
[_loadview setOuterLoaderBuffer:0];

//Move the loader
[_loadview offsetCenterXBy:50.0f];
[_loadview offsetCenterYBy:50.0f];

###Setup properties of loader

//Choose full circle, half circle, or line
[_loadview setLoaderStyle:MBLoaderFullCircle];

//Preset sizes (tiny, small, medium, large)
[_loadview setLoaderSize:MBLoaderLarge];

//If you need greater control over the size
[_loadview setRadius:30];

//Set where the line originates from (full circle style only)
[_loadview setStartPosition:MBLoaderRight];

//Set animation speed
[_loadview setAnimationSpeed:MBLoaderSpeedFast];

###Accessing loader information

//Get the percentage amount that is full (after current animation)
NSInteger amt = [_loadview getPercentage];

##Other useful things

//Hide the loader (useful if error in main app occured)
[_loadview dismiss];

//Turn off interaction blocking
[_loadview allowClicks:YES];

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

Installation

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

pod "MBSimpleLoadingIndicator"

##Troubleshooting

• Open an issue with GitHub's issue reporting system
• Send me an email at [e-mail]
• Send me a tweet at @mattbrenman with #MBLoaderIndicator

Author

mbrenman, [e-mail]

Acknowledgements

• Thanks to Richard for design tips and help
• Used Bohemian Sketch 3 for design and LICEcap for the gifs

License

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