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