iOS-SVProgressHUD进度框

iOS项目开发中SVProgressHUD出现的场景比较高频，上手快，使用简单方便，Show和Dismiss基本上解决了绝大多数的问题.

FlyElephant.png

官方Demo中有三个重要的设置选项，弹出框背景色(Style)，动画类型(AnimationType)及遮罩层颜色(MaskType).

`typedef NS_ENUM(NSInteger, SVProgressHUDStyle) {
 SVProgressHUDStyleLight, // default style, white HUD with black text, HUD background will be blurred on iOS 8 and above
 SVProgressHUDStyleDark, // black HUD and white text, HUD background will be blurred on iOS 8 and above
 SVProgressHUDStyleCustom // uses the fore- and background color properties
 };
 
 
typedef NS_ENUM(NSUInteger, SVProgressHUDMaskType) {
 SVProgressHUDMaskTypeNone = 1, // default mask type, allow user interactions while HUD is displayed
 SVProgressHUDMaskTypeClear, // don't allow user interactions
 SVProgressHUDMaskTypeBlack, // don't allow user interactions and dim the UI in the back of the HUD, as on iOS 7 and above
 SVProgressHUDMaskTypeGradient, // don't allow user interactions and dim the UI with a a-la UIAlertView background gradient, as on iOS 6
 SVProgressHUDMaskTypeCustom // don't allow user interactions and dim the UI in the back of the HUD with a custom color
 };
 
 
typedef NS_ENUM(NSUInteger, SVProgressHUDAnimationType) {
 SVProgressHUDAnimationTypeFlat, // default animation type, custom flat animation (indefinite animated ring)
 SVProgressHUDAnimationTypeNative // iOS native UIActivityIndicatorView
 };`

背景色和动画类型设置:

 [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark]; [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeFlat];

SVProgressHUDMaskType中默认设置的SVProgressHUDMaskTypeNone用户是可以通过遮罩层对视图中的其他进行点击操作的，剩余的四种类型都是不允许进行其他操作.
SVProgressHUDMaskTypeCustom允许用户自定义显示遮罩层的背景颜色:

[SVProgressHUD setBackgroundLayerColor:[[UIColor redColor] colorWithAlphaComponent:0.4]]; [SVProgressHUD setDefaultMaskType:SVProgressHUDMaskTypeCustom];

SVProgressHUD显示的Show方法:

`+ (void)show;
 
 
 
  
(void)showWithMaskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use show and setDefaultMaskType: instead.")));
 
  
(void)showWithStatus:(NSString*)status;
 
  
(void)showWithStatus:(NSString*)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showWithStatus: and setDefaultMaskType: instead.")));
 
  
(void)showProgress:(float)progress;
 
  
(void)showProgress:(float)progress maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showProgress: and setDefaultMaskType: instead.")));
 
  
(void)showProgress:(float)progress status:(NSString*)status;
 
  
(void)showProgress:(float)progress status:(NSString*)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showProgress:status: and setDefaultMaskType: instead.")));
 
  
(void)setStatus:(NSString*)status; // change the HUD loading status while it's showing
 
 
 
 
// stops the activity indicator, shows a glyph + status, and dismisses the HUD a little bit later
 
 
 
  
(void)showInfoWithStatus:(NSString*)status;
 
  
(void)showInfoWithStatus:(NSString*)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showInfoWithStatus: and setDefaultMaskType: instead.")));
 
  
(void)showSuccessWithStatus:(NSString*)status;
 
  
(void)showSuccessWithStatus:(NSString*)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showSuccessWithStatus: and setDefaultMaskType: instead.")));
 
  
(void)showErrorWithStatus:(NSString*)status;
 
  
(void)showErrorWithStatus:(NSString*)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showErrorWithStatus: and setDefaultMaskType: instead.")));
 
 
 
 
// shows a image + status, use 28x28 white PNGs
 
 
 
  
(void)showImage:(UIImage)image status:(NSString)status;
 
  
(void)showImage:(UIImage)image status:(NSString)status maskType:(SVProgressHUDMaskType)maskType attribute((deprecated("Use showImage:status: and setDefaultMaskType: instead.")));`

如果项目中发现SVProgressHUD默认的图片不满足需求，可以通过ShowImage自定义图片实现:

`// shows a image + status, use 28x28 white PNGs
 
 
 
  
(void)showImage:(UIImage)image status:(NSString)status;`

关于弹出框背景颜色，文字颜色，字体大小，偏移量都可以自定义设置:

`+ (void)setDefaultStyle:(SVProgressHUDStyle)style; // default is SVProgressHUDStyleLight
 
 
 
  
(void)setDefaultMaskType:(SVProgressHUDMaskType)maskType; // default is SVProgressHUDMaskTypeNone
 
  
(void)setDefaultAnimationType:(SVProgressHUDAnimationType)type; // default is SVProgressHUDAnimationTypeFlat
 
  
(void)setContainerView:(UIView*)containerView; // default is window level
 
  
(void)setMinimumSize:(CGSize)minimumSize; // default is CGSizeZero, can be used to avoid resizing for a larger message
 
  
(void)setRingThickness:(CGFloat)ringThickness; // default is 2 pt
 
  
(void)setRingRadius:(CGFloat)radius; // default is 18 pt
 
  
(void)setRingNoTextRadius:(CGFloat)radius; // default is 24 pt
 
  
(void)setCornerRadius:(CGFloat)cornerRadius; // default is 14 pt
 
  
(void)setFont:(UIFont*)font; // default is [UIFont preferredFontForTextStyle:UIFontTextStyleSubheadline]
 
  
(void)setForegroundColor:(UIColor*)color; // default is [UIColor blackColor], only used for SVProgressHUDStyleCustom
 
  
(void)setBackgroundColor:(UIColor*)color; // default is [UIColor whiteColor], only used for SVProgressHUDStyleCustom
 
  
(void)setBackgroundLayerColor:(UIColor*)color; // default is [UIColor colorWithWhite:0 alpha:0.5], only used for SVProgressHUDMaskTypeBlack
 
  
(void)setInfoImage:(UIImage*)image; // default is the bundled info image provided by Freepik
 
  
(void)setSuccessImage:(UIImage*)image; // default is the bundled success image provided by Freepik
 
  
(void)setErrorImage:(UIImage*)image; // default is the bundled error image provided by Freepik
 
  
(void)setViewForExtension:(UIView*)view; // default is nil, only used if #define SV_APP_EXTENSIONS is set
 
  
(void)setMinimumDismissTimeInterval:(NSTimeInterval)interval; // default is 5.0 seconds
 
  
(void)setMaximumDismissTimeInterval:(NSTimeInterval)interval; // default is infinite
 
  
(void)setFadeInAnimationDuration:(NSTimeInterval)duration; // default is 0.15 seconds
 
  
(void)setFadeOutAnimationDuration:(NSTimeInterval)duration; // default is 0.15 seconds
 
  
(void)setMaxSupportedWindowLevel:(UIWindowLevel)windowLevel; // default is UIWindowLevelNormal`

SVProgressHUD实现原理也不难，主要通过单例实现:

`+ (SVProgressHUD*)sharedView {
 static dispatch_once_t once;
 
 
static SVProgressHUD *sharedView;
 
 
if !defined(SV_APP_EXTENSIONS)
 
 
dispatch_once(&once, ^{ sharedView = [[self alloc] initWithFrame:[[[UIApplication sharedApplication] delegate] window].bounds]; });
 
 
else
 
 
dispatch_once(&once, ^{ sharedView = [[self alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; });
 
 
endif
 
 
return sharedView;
 
 
}`

通常主线程更新UI的方法如下:

` dispatch_async(dispatch_get_main_queue(), ^{
 
 
});`

SVProgressHUD中的的更新方法如下:

`- (void)showImage:(UIImage)image status:(NSString)status duration:(NSTimeInterval)duration {
 __weak SVProgressHUD *weakSelf = self;
 [[NSOperationQueue mainQueue] addOperationWithBlock:^{
 __strong SVProgressHUD *strongSelf = weakSelf;
 if(strongSelf){
 // Update / Check view hierarchy to ensure the HUD is visible
 [strongSelf updateViewHierarchy];
 
 
        // Reset progress and cancel any running animation
        strongSelf.progress = SVProgressHUDUndefinedProgress;
        [strongSelf cancelRingLayerAnimation];
        [strongSelf cancelIndefiniteAnimatedViewAnimation];
        
        // Update imageView
        UIColor *tintColor = strongSelf.foregroundColorForStyle;
        UIImage *tintedImage = image;
        if (image.renderingMode != UIImageRenderingModeAlwaysTemplate) {
            tintedImage = [image imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
        }
        strongSelf.imageView.tintColor = tintColor;
        strongSelf.imageView.image = tintedImage;
        strongSelf.imageView.hidden = NO;
        
        // Update text
        strongSelf.statusLabel.text = status;
        
        // Show
        [strongSelf showStatus:status];
        
        // An image will dismissed automatically. Therefore we start a timer
        // which then will call dismiss after the predefined duration
        strongSelf.fadeOutTimer = [NSTimer timerWithTimeInterval:duration target:strongSelf selector:@selector(dismiss) userInfo:nil repeats:NO];
        [[NSRunLoop mainRunLoop] addTimer:strongSelf.fadeOutTimer forMode:NSRunLoopCommonModes];
    }
}];
 
 
}`

SVProgressHUD消失除了常用的dismiss方法，还有popActivity,实现代码:

+ (void)popActivity { if([self sharedView].activityCount > 0) { [self sharedView].activityCount--; } if([self sharedView].activityCount == 0) { [[self sharedView] dismiss]; } }

SVProgressHUD内部定义几种常用的视图出现，点击，消失的通知事件:

extern NSString * const SVProgressHUDDidReceiveTouchEventNotification; extern NSString * const SVProgressHUDDidTouchDownInsideNotification; extern NSString * const SVProgressHUDWillDisappearNotification; extern NSString * const SVProgressHUDDidDisappearNotification; extern NSString * const SVProgressHUDWillAppearNotification; extern NSString * const SVProgressHUDDidAppearNotification;

SVProgressHUD中的几种动画效果有单独的文件，有兴趣的可以自己看一下，关于SVProgressHUD的常用时间进行了一下梳理，如有遗漏，欢迎指教~