iOS-SVProgressHUD进度框

作者: FlyElephant | 来源:发表于2017-03-19 11:09 被阅读588次

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

FlyElephant.png

官方Demo中有三个重要的设置选项，弹出框背景色(Style)，动画类型(AnimationType)及遮罩层颜色(MaskType).
<pre><code>`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
};`</code></pre>

背景色和动画类型设置:
<pre><code> [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark]; [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeFlat];</code></pre>

SVProgressHUDMaskType中默认设置的SVProgressHUDMaskTypeNone用户是可以通过遮罩层对视图中的其他进行点击操作的，剩余的四种类型都是不允许进行其他操作.
SVProgressHUDMaskTypeCustom允许用户自定义显示遮罩层的背景颜色:
<pre><code>[SVProgressHUD setBackgroundLayerColor:[[UIColor redColor] colorWithAlphaComponent:0.4]]; [SVProgressHUD setDefaultMaskType:SVProgressHUDMaskTypeCustom];</code></pre>

SVProgressHUD显示的Show方法:
<pre><code>`+ (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.")));`</code></pre>

如果项目中发现SVProgressHUD默认的图片不满足需求，可以通过ShowImage自定义图片实现:
<pre><code>`// shows a image + status, use 28x28 white PNGs

(void)showImage:(UIImage)image status:(NSString)status;`</code></pre>

关于弹出框背景颜色，文字颜色，字体大小，偏移量都可以自定义设置:
<pre><code>`+ (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`</code></pre>

SVProgressHUD实现原理也不难，主要通过单例实现:
<pre><code>`+ (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;

}`</code></pre>

通常主线程更新UI的方法如下:
<pre><code>` dispatch_async(dispatch_get_main_queue(), ^{

});`</code></pre>

SVProgressHUD中的的更新方法如下:
<pre><code>`- (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];
    }
}];

}`</code></pre>

SVProgressHUD消失除了常用的dismiss方法，还有popActivity,实现代码:
<pre><code>+ (void)popActivity { if([self sharedView].activityCount > 0) { [self sharedView].activityCount--; } if([self sharedView].activityCount == 0) { [[self sharedView] dismiss]; } }</code></pre>

SVProgressHUD内部定义几种常用的视图出现，点击，消失的通知事件:
<pre><code>extern NSString * const SVProgressHUDDidReceiveTouchEventNotification; extern NSString * const SVProgressHUDDidTouchDownInsideNotification; extern NSString * const SVProgressHUDWillDisappearNotification; extern NSString * const SVProgressHUDDidDisappearNotification; extern NSString * const SVProgressHUDWillAppearNotification; extern NSString * const SVProgressHUDDidAppearNotification;</code></pre>

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

网友评论

本文标题：iOS-SVProgressHUD进度框

本文链接：https://www.haomeiwen.com/subject/fudmnttx.html

延伸阅读

深度阅读

您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

iOS-SVProgressHUD进度框

if !defined(SV_APP_EXTENSIONS)

else

endif

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

iOS猿媛圈

iOS Developer

闻道丶iOS(尝鲜版)

iOS学习开发

iOS点点滴滴