MBProgressHUD的源码
MBProgressHUD是一个非常受欢迎的第三方库,其用法简单,代码朴实易懂,涉及的知识点广而不深奥,是非常适合初学者阅读的一份源码。本篇内容只是介绍MBProgressHUD的相关属性、方法，以便灵活使用MBProgressHUD。

一、MBProgressHUD.h文件属性解析

1)、MBProgressHUD最大偏移量：MBProgressMaxOffset

// HUD的最大偏移量。设置offset时可用到
extern CGFloat const MBProgressMaxOffset;

2)、模式：MBProgressHUDMode

typedef NS_ENUM(NSInteger, MBProgressHUDMode) {
    // 默认模式：显示菊花，菊花不停地，但没有进度
    MBProgressHUDModeIndeterminate,
    // 圆形饼图来作为进度视图
    MBProgressHUDModeDeterminate,
    // 水平进度条
    MBProgressHUDModeDeterminateHorizontalBar,
    //  圆环作为进度条
    MBProgressHUDModeAnnularDeterminate,
    //  自定义视图，提示图
    MBProgressHUDModeCustomView,
    // 只显示文字
    MBProgressHUDModeText
};

3)、动画形式：MBProgressHUDAnimation

typedef NS_ENUM(NSInteger, MBProgressHUDAnimation) {
    // 默认效果：透明度变化的动画
    MBProgressHUDAnimationFade,
    // 相当于MBProgressHUDAnimationZoomIn
    MBProgressHUDAnimationZoom,
    // 放大消失的效果
    MBProgressHUDAnimationZoomOut,
    // 缩小消失的效果
    MBProgressHUDAnimationZoomIn
};

4)、背景颜色：MBProgressHUDBackgroundStyle

typedef NS_ENUM(NSInteger, MBProgressHUDBackgroundStyle) {
    // 默认背景颜色：透明的
    MBProgressHUDBackgroundStyleSolidColor,
    // MBProgressHUD的背景颜色，若没有设置就是透明色，否则就是设置的颜色。
    MBProgressHUDBackgroundStyleBlur
};

5)、MBProgressHUD显示完成的回调

  typedef void (^MBProgressHUDCompletionBlock)();

6)、两个宏：NS_ASSUME_NONNULL_BEGIN和NS_ASSUME_NONNULL_END

define NS_ASSUME_NONNULL_BEGIN _Pragma("clang assume_nonnull begin")

define NS_ASSUME_NONNULL_END _Pragma("clang assume_nonnull end")

一、在这两个宏之间的代码，所有简单指针都被假定设为非空(nonnull),因此我们只需要去指定那些可为空的(nullable)的指针，这样不用麻烦的去将每个属性或方法都去指定nonnull和nullable，减轻了开发的工作量。
二、为了安全起见，苹果还制定了几条规则：
1.typedef定义的类型的nullability(typeof(COREVIDEO_DECLARE_NULLABILITY))特性通常依赖于上下文，即使是在Nonnull组成的这两个宏定义区域设置中，也不能假定它为nonnull。
2.复杂的指针类型(如id *)必须显示去指定是nonnull还是nullable。例如，指定一个指向nullable对象的nonnull指针，可以使用”__nullable id * __nonnull”。
3.我们经常使用的NSError **通常是被假定为一个指向可为空的nullable NSError对象的nullable指针。

7)、MBProgressHUD的类方法和对象方法

/**
 * @return：返回一个HUD，与类方法hideHUDForView:animated:对应
 * @param：view   HUD要显示的view
 * @param：animated   是否要动画
 */
+ (instancetype)showHUDAddedTo:(UIView *)view animated:(BOOL)animated;

/**
 * @return 返回YES，发现一个HUD并将它移出。否则，什么也不做。
 *  @param：view   显示HUD的view
 * @param：animated   是否要动画
 */
+ (BOOL)hideHUDForView:(UIView *)view animated:(BOOL)animated;

/**
 * @return：返回一个HUD，遍历view的子控件，返回最上面的那个HUD
 *  @param：view   被遍历的view
 */
+ (nullable MBProgressHUD *)HUDForView:(UIView *)view;

/**
 *  @param：view传入的视图对象仅仅做为定义MBProgressHUD视图frame属性的参照
 */
- (instancetype)initWithView:(UIView *)view;

//  是否动画显示HUD
- (void)showAnimated:(BOOL)animated;

// 是否动画隐藏HUD
- (void)hideAnimated:(BOOL)animated;

// 延迟几秒隐藏HUD，与上面不同的是：若只是提示用户直接用这个方法就比较好
- (void)hideAnimated:(BOOL)animated afterDelay:(NSTimeInterval)delay;

8)、MBProgressHUD的属性

//代理
@property (weak, nonatomic) id<MBProgressHUDDelegate> delegate;

// HUD隐藏后的回调
@property (copy, nullable) MBProgressHUDCompletionBlock completionBlock;

/*
 *  作用：防止HUD显示非常短的任务。如果任务非常短就完成了，HUD一闪而过，多不友好。
 * 这时设置这个graceTime就可以防止HUD显示非常短（就不显示了）。也就是说
 * 如果graceTime时间没有走 完而任务完成了，这时就不显示HUD。graceTime默认值为0.
 */
@property (assign, nonatomic) NSTimeInterval graceTime;

/**
 *  最短显示时间，避免HUD刚显示就隐藏的情况，与graceTime有点像，都是避免HUD显示非常短
 */
@property (assign, nonatomic) NSTimeInterval minShowTime;

//  HUD隐藏的时候，是否从Super上移出。默认是NO。
@property (assign, nonatomic) BOOL removeFromSuperViewOnHide;

// HUD的形式，mode值是上面模式的值
@property (assign, nonatomic) MBProgressHUDMode mode;

// 设置HUD的子控件的颜色，label和进度模式都是contentColor
@property (strong, nonatomic, nullable) UIColor *contentColor UI_APPEARANCE_SELECTOR;

// HUD显示与隐藏的动画形式
@property (assign, nonatomic) MBProgressHUDAnimation animationType UI_APPEARANCE_SELECTOR;

//  HUD默认是显示在super控件的中央，offset就是HUD相对于super控件中央的偏移量
@property (assign, nonatomic) CGPoint offset UI_APPEARANCE_SELECTOR;

//  margin是HUD的子控件到HUD的边距（最小边距），默认是20.f。
@property (assign, nonatomic) CGFloat margin UI_APPEARANCE_SELECTOR;

// 背景框的大小。默认值为CGSizeZero，
@property (assign, nonatomic) CGSize minSize UI_APPEARANCE_SELECTOR;

// 是否强制背景框宽高相等
@property (assign, nonatomic, getter = isSquare) BOOL square UI_APPEARANCE_SELECTOR;

// 这个属性没用过，也没试出来。
@property (assign, nonatomic, getter=areDefaultMotionEffectsEnabled) BOOL defaultMotionEffectsEnabled UI_APPEARANCE_SELECTOR;

// 进度条的进度（从0.0到1.0变化）
@property (assign, nonatomic) float progress;

// 任务进度管理对象
@property (strong, nonatomic, nullable) NSProgress *progressObject;

//  MBBackgroundView的对象只可读
@property (strong, nonatomic, readonly) MBBackgroundView *bezelView;

//  MBBackgroundView的对象只可读
@property (strong, nonatomic, readonly) MBBackgroundView *backgroundView;

//MBProgressHUDModeCustomView模式下实现自定义view
@property (strong, nonatomic, nullable) UIView *customView;

// 短消息提示label，自动调整大小，只可读。
@property (strong, nonatomic, readonly) UILabel *label;

// 与上面的简短提示来说，这次提示就比较详细了，也是只可读
@property (strong, nonatomic, readonly) UILabel *detailsLabel;

//单个任务是，耗时比较长时，可以设置一个取消按钮，取消此次任务。
@property (strong, nonatomic, readonly) UIButton *button;

9)、MBProgressHUD的代理MBProgressHUDDelegate

只有一个用于HUD隐藏时的回调方法：跟属性中completionBlock属性的block回调一样。
- (void)hudWasHidden:(MBProgressHUD *)hud;

二、MBBackgroundView背景视图

 //HUD的背景样式（透明或HUD的背景颜色）
@property (nonatomic) MBProgressHUDBackgroundStyle style;

  //设置HUD的背景颜色
@property (nonatomic, strong) UIColor *color;