关于MBHUD（MBProgressHUD）的简单封装使用和踩得坑

  • 常用样式C语法便捷封装
  • 定制化使用
  • 踩过的坑

⚠️文章中版本为：pod 'MBProgressHUD','1.1.0'；后续版本activityIndicatorColor属性被弃用，请自行修改⚠️

一、常用样式C语法便捷封装

话不多说 先上代码
  1. 根据我当前的项目需求，大致需要三种样式的HUD：菊花转、提示框、上传下载进度展示。为了方便使用，抽成了C方法，头文件部分如下。

@interface MBProgressHUD (YTTool)

/** 显示仅有菊花的loading框 到 window   HUD是否需要霸屏 */
extern void HUDShowOnlyLoading(BOOL canEnabled);
/** 显示仅有菊花的loading框 到 superView    HUD是否需要霸屏 */
extern void HUDShowOnlyLoadingToView(BOOL canEnabled, UIView *superView);
/** 显示仅有菊花的loading框 到 superView atime 秒   HUD是否需要霸屏 */
extern void HUDShowOnlyLoadingToViewATime(BOOL canEnabled, UIView *superView, CGFloat atime);


/** 显示自动消失的提示框到 window */
extern void HUDShowTips(NSString *msg,BOOL canEnabled);
/** 显示自动消失的提示框到 superView 2 秒 */
extern void HUDShowTipsToView(BOOL canEnabled, NSString *msg,UIView *superView);
/** 显示自动消失的提示框到 superView aTime 秒 */
extern void HUDShowTipsToViewATime(BOOL canEnabled, NSString *msg, UIView *superView, CGFloat aTime);


/** 显示上传或下载圆环进度框 */
extern void HUDShowDownLoadProgress(CGFloat progress);
extern void HUDShowProgress(NSString *msg, CGFloat progress);
extern void HUDShowProgressToView(NSString *msg, CGFloat progress, UIView *superView);


 /** 隐藏所有HUD */
extern void HideHUD(UIView *view);

@end
  1. 具体实现如下：

@implementation MBProgressHUD (FYTool)
#pragma mark - loading
/** 显示仅有菊花的loading框 到 window HUD是否需要霸屏 */
void HUDShowOnlyLoading(BOOL canEnabled) {
    if (![NSThread isMainThread]) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:KEYWINDOW withShowTime:0];
        });
    }else [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:KEYWINDOW withShowTime:0];
}
/** 显示仅有菊花的loading框 到 superView HUD是否需要霸屏 */
void HUDShowOnlyLoadingToView(BOOL canEnabled, UIView *superView) {
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(superView)
            [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:strongSelf withShowTime:0];
        });
    }else [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:superView withShowTime:0];
}
/** 显示仅有菊花的loading框 到 superView atime 秒 HUD是否需要霸屏 */
void HUDShowOnlyLoadingToViewATime(BOOL canEnabled, UIView *superView, CGFloat atime){
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(superView)
            [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:strongSelf withShowTime:atime];
        });
    }else [MBProgressHUD showLoadingStyleHUDWith:canEnabled withSuperView:superView withShowTime:atime];
}

#pragma mark - tips
/** 显示自动消失的提示框到 window */
void HUDShowTips(NSString *msg,BOOL canEnabled){
    if (![NSThread isMainThread]) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:KEYWINDOW withShowTime:0];
        });
    }else [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:KEYWINDOW withShowTime:0];
}
/** 显示自动消失的提示框到 superView 2 秒 */
void HUDShowTipsToView(BOOL canEnabled, NSString *msg,UIView *superView) {
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(superView)
            [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:strongSelf withShowTime:0];
        });
    }else [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:superView withShowTime:0];
}
/** 显示自动消失的提示框到 superView aTime 秒 */
void HUDShowTipsToViewATime(BOOL canEnabled, NSString *msg, UIView *superView, CGFloat aTime) {
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(superView)
            [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:strongSelf withShowTime:aTime];
        });
    }else [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:superView withShowTime:aTime];
}

#pragma mark - progress
void HUDShowDownLoadProgress(CGFloat progress) {
    if (![NSThread  isMainThread]) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [MBProgressHUD showProgressHUDWith:nil withSuperView:KEYWINDOW withProgress:progress];
        });
    }else
        [MBProgressHUD showProgressHUDWith:nil withSuperView:KEYWINDOW withProgress:progress];
}

void HUDShowProgress(NSString *msg, CGFloat progress) {
    if (![NSThread isMainThread]) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [MBProgressHUD showProgressHUDWith:msg withSuperView:KEYWINDOW withProgress:progress];
        });
    }else [MBProgressHUD showProgressHUDWith:msg withSuperView:KEYWINDOW withProgress:progress];
}

void HUDShowProgressToView(NSString *msg, CGFloat progress, UIView *superView){
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(superView)
            [MBProgressHUD showProgressHUDWith:msg withSuperView:strongSelf withProgress:progress];
        });
    }else [MBProgressHUD showProgressHUDWith:msg withSuperView:superView withProgress:progress];
}

#pragma mark - hide
/** 隐藏所有HUD */
void HideHUD(UIView *view) {
    if (![NSThread isMainThread]) {
        @weakObj(view)
        dispatch_async(dispatch_get_main_queue(), ^{
            @strongObj(view)
            [MBProgressHUD hideHUDWithSuperViw:strongSelf];
        });
    }else{
        [MBProgressHUD hideHUDWithSuperViw:view];
    }
    
}

#pragma mark -
+ (void)showLoadingStyleHUDWith:(BOOL)canEnabled withSuperView:(UIView *)view withShowTime:(CGFloat)aTime {
    MBProgressHUD * hud = [MBProgressHUD HUDForView:view];
    if (!hud) {
        hud =[MBProgressHUD showHUDAddedTo:view ? view : KEYWINDOW animated:YES];
    }else{
        [hud showAnimated:YES];
    }
    hud.minSize = CGSizeMake(60, 60);
    hud.bezelView.style = MBProgressHUDBackgroundStyleSolidColor;
    hud.bezelView.backgroundColor = HexColorRGBA(0x000000, 0.2);
    hud.bezelView.layer.cornerRadius = 10.;
    hud.mode = MBProgressHUDModeIndeterminate; //菊花，默认值
    hud.label.text = nil;
    hud.detailsLabel.text = nil;
    hud.activityIndicatorColor = [UIColor whiteColor];
    hud.offset = CGPointZero;
    //    [hud setContentColor:[UIColor whiteColor]];
    hud.tintColor = [UIColor whiteColor];
    hud.removeFromSuperViewOnHide = YES;
    
    hud.userInteractionEnabled = !canEnabled;
    
    if (aTime > 0.5) {
        [hud hideAnimated:YES afterDelay:aTime];
    }
}

+ (void)showTipsStyleHUDWith:(BOOL)canEnabled withTipsContent:(NSString *)tipsStr withSuperView:(UIView *)view withShowTime:(CGFloat)aTime {
    MBProgressHUD * hud = [MBProgressHUD HUDForView:view];
    if (!hud) {
        hud =[MBProgressHUD showHUDAddedTo:view ? view : KEYWINDOW animated:YES];
    }
    hud.mode = MBProgressHUDModeText;
    hud.animationType = MBProgressHUDAnimationZoomOut;
    hud.bezelView.backgroundColor = HexColorRGBA(0x000000, 0.85);
    hud.backgroundView.alpha = 0.85;
    
    hud.label.text = tipsStr.length > 0 ? tipsStr : @"😰网络好像有点问题😰";
    
    hud.detailsLabel.text = nil;
    hud.minSize = CGSizeMake(110, 40);
    hud.margin = 15.;
    hud.bezelView.layer.cornerRadius = 20.;
    hud.label.font=[UIFont systemFontOfSize:16];
    hud.label.textColor = HEXCOLOR(0xf0f0f0); //[UIColor whiteColor];
    hud.label.numberOfLines = 0;
    hud.offset = CGPointMake(0, -100);
    hud.userInteractionEnabled = !canEnabled;
    
    if (aTime > 0.5) {
        [hud hideAnimated:YES afterDelay:aTime];
    }
}

+ (void)showProgressHUDWith:(NSString *)tipsStr withSuperView:(UIView *)view withProgress:(CGFloat)progress{
    
    MBProgressHUD * hud = [MBProgressHUD HUDForView:view];
    if (!hud) {
        hud =[MBProgressHUD showHUDAddedTo:view ? view : KEYWINDOW animated:YES];
        hud.progress = MAX(0.01, progress);
    }else{
        hud.progress = MAX(0.01, progress);
        [hud showAnimated:YES];
    }
    hud.minSize = CGSizeMake(160, 80);
    
    hud.label.text = [NSString stringWithFormat:@"%2.f%%",MAX(0.01, progress)*100];
    hud.label.font = [UIFont systemFontOfSize:12];
    hud.label.textColor = [UIColor whiteColor];
    hud.label.numberOfLines = 0;
    hud.offset = CGPointMake(0, -40);//相对于hud父视图偏移
    
    hud.bezelView.style = MBProgressHUDBackgroundStyleSolidColor;
    hud.bezelView.backgroundColor = HexColorRGBA(0x000000, 0.25);
    
    hud.detailsLabel.text = tipsStr.length > 0 ? tipsStr :@"正在保存到本地";
    hud.detailsLabel.textColor = [UIColor whiteColor];

    hud.mode = MBProgressHUDModeAnnularDeterminate;//圆环作为进度条
    
    hud.removeFromSuperViewOnHide = YES;
    [hud setContentColor:[UIColor whiteColor]];//HEXCOLOR(0x448bf2)
    hud.backgroundView.style = MBProgressHUDBackgroundStyleSolidColor;
    
    if (hud.progress >= 1) {
        [hud hideAnimated:YES afterDelay:1];
    }
}

#pragma mark -
+ (void)hideHUDWithSuperViw:(UIView *)view{
    if (view) {
        [MBProgressHUD hideHUDForView:view animated:YES];
    }
    [MBProgressHUD hideHUDForView:KEYWINDOW animated:YES];
}

@end

二、定制化使用

1、有一期需求中，需要细微调整样式且不要模糊背景层；发现无论怎么调都会有一个UIVisualEffectView类型的backgroundView衬底，然后缺无法访问控制其隐藏。多次尝试无果，就耍个流氓吧，将其移除😜。
- (void)removeEffectView{
    [self.bezelView.subviews enumerateObjectsUsingBlock:^(__kindof UIView * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        if ([obj.class isEqual:[UIVisualEffectView class]]) {
            [obj removeFromSuperview];
        }
    }];
}

+ (MBProgressHUD *)showTipsStyleHUDWith:(BOOL)canEnabled withTitleFont:(UIFont *)tFont withTitleColor:(UIColor *)titleColor withBezelBGColor:(UIColor *)bezelBGC withTipsContent:(NSString *)tipsStr withSuperView:(UIView *)view withShowTime:(CGFloat)aTime{
    MBProgressHUD * hud = [MBProgressHUD HUDForView:view];
    if (!hud) {
        hud =[MBProgressHUD showHUDAddedTo:view ? view : KEYWINDOW animated:YES];
    }
    hud.mode = MBProgressHUDModeText;
    hud.animationType = MBProgressHUDAnimationZoomOut;
//    hud.backgroundView.alpha = 0.85;
    
    tipsStr = tipsStr.length > 0 ? tipsStr : @"😰网络好像有点问题😰";
    hud.label.text = tipsStr;
    
    hud.detailsLabel.text = nil;
    hud.minSize = CGSizeMake(110, 50);
    hud.margin = 20.;
    hud.bezelView.layer.cornerRadius = 5.;
    hud.label.font = tFont ? tFont : TEXT_FONT(16);
    hud.label.textColor = titleColor ? titleColor : [UIColor whiteColor];
    hud.label.numberOfLines = 0;
    hud.offset = CGPointZero;// CGPointMake(0, -100);
    hud.userInteractionEnabled = !canEnabled;
    hud.bezelView.backgroundColor = bezelBGC ? bezelBGC : HexColorRGBA(0x000000, 0.75);
    
    [hud hideAnimated:YES afterDelay:MAX(aTime, 1.2) + (tipsStr.length > 25 ? 1 : 0)];
    
    return hud;
}

关于使用

 [[MBProgressHUD showTipsStyleHUDWith:YES withTitleFont:TEXT_FONT_Medium(13) withTitleColor:HexColorRGBA(0xffffff, 1) withBezelBGColor:[UIColor clearColor] withTipsContent:@"tips tips tips..." withSuperView:self.containerView withShowTime:2] removeEffectView];
2、有朋友说想等HUD显示结束之后做操作；稍稍把上边函数修改一下给个返回值实现completeBlock即可。如下：
/** 显示自动消失的提示框到 superView aTime 秒
 *  会返回该对象本身，如需等待HUD显示结束执行操作可自行实现其completeblock
 */
extern MBProgressHUD * HUDShowTipsToViewATimeAndReturnThis(BOOL canEnabled, NSString *msg, UIView *superView, CGFloat aTime);


MBProgressHUD * HUDShowTipsToViewATimeAndReturnThis(BOOL canEnabled, NSString *msg, UIView *superView, CGFloat aTime){
    __block MBProgressHUD *hud;
    if (![NSThread isMainThread]) {
        @weakObj(superView)
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            @strongObj(superView)
            hud = [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:strongSelf withShowTime:MAX(1, aTime) + 0.5];
        });
    }else  hud = [MBProgressHUD showTipsStyleHUDWith:canEnabled withTipsContent:msg withSuperView:superView withShowTime:MAX(1, aTime)];
    
    return hud;
}

    [HUDShowTipsToViewATimeAndReturnThis(YES, @"提示一下", nil, 3.) setCompletionBlock:^{
        // do some operation

    }];

三、踩过的坑😄

为什么说还踩了坑呢？
简单来说就是：子线程切换到主线程更新HUD的展示，例如上传和下载的时候。
主要是项目中接入了 阿里云的OSS ，既然支持了客户端直传，那下载也必然会用OSS的SDK自带的🌶~

用过OSS SDK的应该都知道，OSSTask这个类有个waitUntilFinished方法，使任务串行执行，可以在批量上传的时候确保顺序。然而在使其task等待的同时，这个task的OSSGetObjectRequest对象中的downloadProgress进度回调也会被等待，进而使

request.downloadProgress = ^(int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite) {};

也被等待，使downloadProgress代码块内更新HUD的任务被堆积。一直到等待结束瞬间执行完堆积的N次更新。。。

🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣

最后，值得注意的是，之前看有人发现偶尔会有显示出的hud隐藏不掉，个人感觉大概有两种可能：
1、hideHUDWithSuperViw方法隐藏的是你指定view上添加的HUD，show的时候和hide的时候传入的view不是同一个将会隐藏不掉。
2、在viewcontroller里的某个block外进行了HUD的添加显示，block内进行hide，此时的self是哪个weak修饰过的，当VC被释放的时候也有可能隐藏不掉hud。这种情况个人建议先weak再strong。

如果还有一些使用场景没提到的，欢迎评论区留意🤝

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
禁止转载，如需转载请通过简信或评论联系作者。
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 212,029评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,395评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,570评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,535评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,650评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,850评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,006评论 3赞 408
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,747评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,207评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,342评论 4赞 330
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,964评论 3赞 315
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2赞 349