MBProgressHUD 常用扩展

MBProgressHUD

前言: 日常开发中，常需要对 MBProgressHUD 进行扩展。

---

MBProgressHUD 常用属性

bezelView:
The view containing the labels and indicator (or customView) .也就是你平时看到的那个 view，用于显示提示信息。

bezelView -> style:
可以通过设置 style 来改变提示框的样式。

• 毛玻璃样式（默认）
  • 设置 bezelView 的背景色为 clear 来实现完全的毛玻璃
    
• 普通样式
  • 设置 style 为 MBProgressHUDBackgroundStyleSolidColor
    
  • 这时候你可以通过设置 bezelView 的背景色为 clear 来实现无背景效果

backgroundView:
在 bezelView 之下。整个 HUD 覆盖的区域，默认铺满添加 HUD 的 view。最好不要去设置它的 frame 。
因为 backgroundView 的 userInterfaceEnabled 默认是 YES， 所以当 HUD 显示时，被覆盖的 view 无法响应用户。如果需要这时候也可以响应用户，设置 HUD 的 userInterfaceEnabled 属性为 NO 。

userInterfaceEnabled:
即 backgroundView 中提到的 userInterfaceEnabled。

mode:
HUD 的结构。常使用 MBProgressHUDModeCustomView 。

offset:
bezelView 的 center 相对[添加 HUD 的 view 的 center]的偏移量。

margin:
提示信息的控件在 bezelView 上的边距，默认是 20 。

removeFromSuperViewOnHide:
当 HUD hidden 时，是否从 superView 上移除，默认是 NO，一般设置为 YES。

label、detailLabel、customView、button:
bezelView 上用于显示提示信息的 view。

---

MBProgressHUD 个人常用扩展

.h

#import <MBProgressHUD/MBProgressHUD.h>

@interface MBProgressHUD (ChEx)

/**
*  展示短暂的提示框
*
*  @param message 提示语
*  @param image   提示图片
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowTipHUDWithMsg:(NSString *)message image:(UIImage *)image toVc:(UIViewController *)vc;

/**
*  展示带有 indicator 的提示框（需要手动结束）
*
*  @param message 提示语
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowWithIndicatorMsg:(NSString *)message toVc:(UIViewController *)vc;

/**
*  展示没有 indicator 的提示框（需要手动结束）
*
*  @param message 提示语
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowMsg:(NSString *)message toVc:(UIViewController *)vc;

/**
*  移除 vc.view 上的 HUD
*
*  @param vc 如果 vc 为 nil ，那么将会移除 window 上的 HUD
*/
+ (void) chExHiddenHUDForVc:(UIViewController *)vc;

@end   

.m

#import "MBProgressHUD+ChEx.h"


static NSString *const kHudMagin = @"5";
static NSString *const kHudShowTimerval = @"1.5";
static NSString *const kHudFontSize = @"15";


#define HUD_FRAME CGRectMake(0, 128, CH_SCREEN_WIDTH, CH_SCREEN_HEIGHT - 128)

@implementation MBProgressHUD (ChEx)

/**
*  展示短暂的提示框
*
*  @param message 提示语
*  @param image   提示图片
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowTipHUDWithMsg:(NSString *)message image:(UIImage *)image toVc:(UIViewController *)vc {
    CH_MAIN_BLOCK(^{
        MBProgressHUD *hud;
        if (vc.view) {
            hud = [[MBProgressHUD alloc]initWithView:vc.view];
            [vc.view addSubview:hud];
            if (vc.edgesForExtendedLayout == 0) {
                hud.offset = CGPointMake(0, -32);
            }
        }
        else {
            hud  = [[MBProgressHUD alloc] initWithFrame:HUD_FRAME];
            [[self lastWindow] addSubview:hud];
            hud.offset = CGPointMake(0, -64);
        }
        hud.mode = MBProgressHUDModeCustomView;
        [self styleWithHUD:hud];
        if (image) {
            UIImageView *imageView = [[UIImageView alloc]initWithImage:image];
            hud.customView = imageView;
        }
        if (message) {
            hud.label.font = [UIFont systemFontOfSize:kHudFontSize.integerValue];
            hud.label.text = message;
        }
        [hud showAnimated:YES];
        [hud hideAnimated:YES afterDelay:kHudShowTimerval.floatValue];
    });
}

/**
*  展示带有 indicator 的提示框（需要手动结束）
*
*  @param message 提示语
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowWithIndicatorMsg:(NSString *)message toVc:(UIViewController *)vc {
    [self chExShowHUDWithMsg:message toVc:vc mode:MBProgressHUDModeIndeterminate];
}
/**
*  展示没有 indicator 的提示框（需要手动结束）
*
*  @param message 提示语
*  @param vc      用来显示提示的 vc。如果 vc 为 nil 那么将显示在 window 上
*/
+ (void) chExShowMsg:(NSString *)message toVc:(UIViewController *)vc {
    [self chExShowHUDWithMsg:message toVc:vc mode:MBProgressHUDModeCustomView];
}

+ (void) chExShowHUDWithMsg:(NSString *)message toVc:(UIViewController *)vc mode:(MBProgressHUDMode)mode {
    CH_MAIN_BLOCK(^{
        MBProgressHUD *hud;
        if (vc.view) {
            hud = [[MBProgressHUD alloc]initWithView:vc.view];
            [vc.view addSubview:hud];
            if (vc.edgesForExtendedLayout == 0) {
                hud.offset = CGPointMake(0, -32);
            }
        }
        else {
            hud = [[MBProgressHUD alloc] initWithFrame:HUD_FRAME];
            [[self lastWindow] addSubview:hud];
            hud.offset = CGPointMake(0, -64);
        }
        hud.mode = mode;
        [self styleWithHUD:hud];
        if (message) hud.label.text = message;
        [hud showAnimated:YES];
    });
}

+ (void) chExHiddenHUDForVc:(UIViewController *)vc {
    CH_MAIN_BLOCK(^{
        if (vc.view)
            [self hideHUDForView:vc.view animated:YES];
        else
            [self hideHUDForView:[self lastWindow] animated:YES];
    });
}

#pragma mark
#pragma mark pravite method

+ (void) styleWithHUD:(MBProgressHUD *)hud {
    hud.margin = kHudMagin.integerValue;
    hud.bezelView.style = MBProgressHUDBackgroundStyleBlur;
    hud.bezelView.backgroundColor = [UIColor redColor];
    hud.removeFromSuperViewOnHide = YES;
}

+ (UIView *) lastWindow {
    return [[UIApplication sharedApplication].windows lastObject];
}


@end

说明:

• 所有接口都不会遮挡导航栏
• 使用 UIViewController 作为参数，而没使用 UIView ，因为 iOS 7 之后视图布局由变更导航栏遮挡视图
  
• 如何使用 window 来承载 HUD 却不遮挡导航栏Here

转载于:https://www.cnblogs.com/imock/p/6553065.html