GMDCircleLoader is a neat and easy to use loading view meant to replicate Apple’s progress loading view of an ongoing task.
- Drag the
GMDCircleLoader/GMDCircleLoaderfolder into your project. - Add the QuartzCore framework to your project.
- Update the definitions on your Header file if necessary.
- #import “GMDCircleLoader.h” on your implementation file or add it to your projects prefix file.
(see sample Xcode project)
Use GMDCircleLoader wisely! Bad use case examples: pull to refresh, infinite scrolling, sending message.
Using GMDCircleLoader in your app will usually look as simple as this:
- (void)loginTwitter:(id)sender {
[GMDCircleLoader setOnView:self.view withTitle:@"Loading..." animated:YES];
[[Twitter sharedInstance] loginWithCompletion:^(TWTRSession *session, NSError *error) {
if (session) {
[GMDCircleLoading hideHUDFromView:self.view animated:YES];
}
}You can show the status of indeterminate tasks using one of the following:
+ (GMDCircleLoader *)setOnView:(UIView *)view withTitle:(NSString *)title animated:(BOOL)animated;It can be dismissed right away using:
+ (BOOL)hideFromView:(UIView *)view animated:(BOOL)animated;You can include an image to show in the middle of the loading circle by simply uncommenting:
UIImageView *img = [[UIImageView alloc] initWithFrame:GMD_SPINNER_IMAGE];
img.image = GMD_IMAGE;
hud.center = img.center;
[hud addSubview:img];- Create singleton
- Create additional status options, including no label loader.
- Reduce view frame from bounds to something more manageable.
If you have feature requests or bug reports, feel free to help out by sending pull requests or by creating new issues.
Please take a moment to review the guidelines written by Nicolas Gallagher:
GMDCircleLoader is brought to you by Gabe Morales and contributors to the project.
If you're using GMDCircleLoader in your project, attribution would be nice.
GMDCircleLoader is released under MIT License.