• Stars
    star
    287
  • Rank 144,232 (Top 3 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created almost 10 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

MBSimpleLoadingIndicator

demo

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];

animprops

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 occurred)
[_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 [email protected]
  • Send me a tweet at @mattbrenman with #MBLoaderIndicator

Author

mbrenman, [email protected]

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.