OC_MBProgressHUD常用属性和用法

参考文献：

• 源码篇：MBProgressHUD
• MBProgressHUD详解

---

MBHUD的外观组成

---

• 1.loading动画视图
• 2.标题文本框(label)
• 3.详情文本框(detailsLabel)
• 4.HUD背景框
  具体效果如下：

Snip20160908_5.png

基本属性设置

    /*显示HUD的步骤：1.创建MBProgressHUD对象 2.将对象添加到视图  3.调用show方法*/
    /*隐藏HUD的两种方法：1.hide：  2.hid：afterDelay：*/
   
    self.hud = [[MBProgressHUD alloc]init];
    [self.view addSubview:self.hud];

 /**1.设置hud的模式：loading动画视图的效果*/
//    self.hud.mode = MBProgressHUDModeIndeterminate;//菊花样式，默认值
    
//    self.hud.mode = MBProgressHUDModeDeterminate;//圆饼图
    
//    self.hud.mode = MBProgressHUDModeDeterminateHorizontalBar;//进度条
    
    self.hud.mode = MBProgressHUDModeAnnularDeterminate;//圆环进度条
    
//    self.hud.mode = MBProgressHUDModeCustomView;//设置自定义视图时，设置属性值为这个
    
//    self.hud.mode = MBProgressHUDModeText;//只显示文本，通过labelText设置文本内容
    
//    self.hud.labelText = @"输入有误 ";
    
    /**2.HUD背景框的属性*/
    //       self.hud.opacity = 0.1;//设置背景框的透明度，默认为0.8，设置完颜色和颜色通道之后该属性失效
    
//    self.hud.color = [UIColor blackColor];//设置背景颜色
    
//    self.hud.color = [self.hud.color colorWithAlphaComponent:0.5];//设置背景色通道
    
//    self.hud.cornerRadius = 20;//设置背景框的圆角值，默认是10
    
    //    self.hud.xOffset = 80;//设置提示框相对于父视图中心点的偏移值
    
//    self.hud.yOffset = 80;//
    
//    self.hud.margin = 40;//设置各个元素距离矩形边框的距离，可以根据这个设置提示框的大小
    
//    self.hud.minSize = CGSizeMake(10, 10);//背景框的最小大小
    
//    self.hud.square = YES;

    /**3.设置详情框的属性*/
//    self.hud.detailsLabelColor = [UIColor orangeColor];//设置详情文本颜色
//    
//    self.hud.detailsLabelFont = [UIFont systemFontOfSize:13];//设置详情文本大小
//    
//    self.hud.detailsLabelText = @"loading...";//设置详情文本内容
//    

    /**4.设置标题框的属性*/
    self.hud.labelText = @"系统提示";//设置标题文本内容

    self.hud.label.font = [UIFont systemFontOfSize:14];//设置标题文本大小

    self.hud.label.color = [UIColor greenColor];//设置标题文本颜色
    
    /**设置显示和消失切换时的动画效果*/

//    self.hud.animationType = MBProgressHUDAnimationFade;//渐变消失
    
    self.hud.animationType = MBProgressHUDAnimationZoomOut;//缩小消失
    
//    self.hud.animationType = MBProgressHUDAnimationZoomIn;//放大消失
    
//    self.hud.minShowTime = 3;//设置最短显示时间，避免显示后立刻被隐藏  默认是0
    

    
    
//    /**其他设置*/
    self.hud.activityIndicatorColor = [UIColor greenColor];//设置菊花（活动指示器）颜色
//
//    self.hud.dimackground = YES;//设置一个渐变背景层
//
//    self.hud.removeFromSuperViewOnHide = NO;//设置隐藏的时候是否从父视图中移除，默认是no
//    
//    self.hud.progress = 0.5;//进度指示器  模式是0，取值从0.0-1.0

//    self.hud.minShowTime = 3;//设置最短显示时间

    [self.hud show:YES];//设置完成后显示hud

//    [self.hud hide:YES];//隐藏hud

//[self.hud hide:YES afterDelay:5];//5秒后隐藏HUD

//隐藏hud后调用的block
    self.hud.completionBlock = ^{
       NSLog(@"----------block");
    };

---

实现加载进度条

---

-(void)viewDidLoad
{
  //创建hud
  self.hud = [[MBProgressHUD alloc]init];
  //将hud添加到视图
    [self.view addSubview:self.hud];
  //设置加载进度条的动画效果
   self.hud.mode = MBProgressHUDModeAnnularDeterminate;
    //设置任务
    [self.hud showWhileExecuting:@selector(myProgressTask)   onTarget:self withObject:nil animated:YES];
  [self.hud show];
}

//任务，测试进度显示
- (void)myProgressTask {
    // This just increases the progress indicator in a loop
    float progress = 0.0f;
    while (progress < 1.0f) {
        progress += 0.01f;
        HUD.progress = progress;//记录任务完成值
        usleep(50000);
    }
}

运行结果

屏幕快照 2016-09-08 下午7.53.40.png

---

graceTime和taskInProgress使用示例

---

• graceTime:这个属性是一个宽限期，如果被监听的任务没有在宽限期内完成，则会显示HUD，如果在宽限期内完成则不显示HUD。被监听的任务需要将taskInProgress属性设置为yes。具体实现如下

-(void)viewDidLoad
{
  //创建hud
  self.hud = [[MBProgressHUD alloc]init];
  //将hud添加到视图
    [self.view addSubview:self.hud];
  //设置加载进度条的动画效果
   self.hud.mode = MBProgressHUDModeAnnularDeterminate;
    //设置任务
    [self.hud showWhileExecuting:@selector(myProgressTask)   onTarget:self withObject:nil animated:YES];
    self.hud.graceTime = 2;
}

- (void)myProgressTask {
    float progress = 0.0f;
    while (progress < 1.0f) {
        NSLog(@"---");
        progress += 0.01f;
        self.hud.taskInProgress = YES;
        usleep(60000);
    }
}

---

常用方法

---

• showWhileExecuting:onTarget:withObject:animated:它是基于target-action方式的调用，在执行一个后台任务时显示HUD，等后台任务执行完成后再隐藏HUD
• -showAnimated:whileExecutingBlock:onQueue:completionBlock:
  它是基于GCD的调用，当block中的任务在指定的队列中执行时，显示HUD窗口，任务完成之后执行completionBlock操作，最后隐藏HUD窗口。我们来看看它的具体实现：

---

其它

---

• 显示和隐藏的便捷方法

+ (MB_INSTANCETYPE)showHUDAddedTo:(UIView *)view animated:(BOOL)animated
 
+ (BOOL)hideHUDForView:(UIView *)view animated:(BOOL)animated
 
+ (NSUInteger)hideAllHUDsForView:(UIView *)view animated:(BOOL)animated

• MBProgressHUD还为我们提供了一个代理MBProgressHUDDelegate，这个代理中只提供了一个方法，即：

- (void)hudWasHidden:(MBProgressHUD *)hud;//隐藏HUD后调用的方法