DDProgressHUD

Progress 进度条，UIActivityIndicatorView 小菊花，弹窗，状态显示，高度自定义

DDProgressHUD的介绍

提供了四种类型的展示：

显示无限旋转的加载图(比如小菊花，可以自定义)，显示文字信息。网络刷新时经常用到。

显示加载进度的动画，也可以显示文字。网络下载时用的比较多，加载网页时也可以用。

与用户弹窗交互的弹窗，告知用户当前操作的状态，成功还是失败，显示一张图片和文字。图片和文字也都可自定义

可高度自定义的弹窗，将一个view显示在遮罩上面，相当于做了一个蒙版

最后旋转的菊花，提供了一个view的扩展，将UIActivityIndicatorView小菊花显示在调用者中间位置。

DDProgressHUD的简单使用与方法介绍

准备

下载代码：使用很简单，将工程从github： https://github.com/mddios/DDProgressHUD 下载下来，将DDProgressHUD文件全部拖入工程

包含DDProgressHUD.h头文件即可使用

不用考虑线程的问题，主线程和非主线程均可以

工程现在下来可以看到是一个demo，点击上面的按钮就一目了然

为了方便管理与自定义，建议还是fork一份到自己的github

简单使用与方法介绍

第一类显示提供三个类方法：无限循化的图片

/// 只显示图片，一直显示直到调用dismiss方法

+ (void)show;

/// 显示图片和文字，一直显示直到调用dismiss方法

+ (void)showWithStatus:(NSString *)status;

/// 很明显，显示时间由duration决定，当然，中途也可以调用dismiss方法来取消显示

+ (void)showWithStatus:(NSString *)status andDuration:(NSTimeInterval)duration;

第二类显示提供2个类方法：加载进度

/// 显示进度，不会自动消失，需要调用dismiss方法,progress 取值范围0~1

+ (void)showProgress:(CGFloat)progress;

/// 显示进度，和一段描述，不会自动消失，需要调用dismiss方法

+ (void)showProgress:(CGFloat)progress withStatus:(NSString *)status;

第三类显示提供6个类方法：弹窗，显示图片和文字

/// 成功弹窗，只显示图片，

+ (void)showSuccessImage;

/// 成功状态图片和info

+ (void)showSuccessImageWithInfo:(NSString *)info;

/// 错误弹窗，只显示图片

+ (void)showErrorImage;

/// 错误状态图片和info

+ (void)showErrorImageWithInfo:(NSString *)info;

/// 显示自定义图片和文字信息，视图大小会根据文字和图片的大小自动调整

+ (void)showImage:(UIImage *)image andInfo:(NSString *)info;

/// 显示自定义图片和文字信息时间到后自动消失，视图大小会根据文字和图片的大小自动调整

+ (void)showImage:(UIImage *)image andInfo:(NSString *)info andDuration:(CGFloat)duration;

关于显示时间的问题：会根据传入的Info长短来计算一个时间，然后和最大时间、最小时间做比较，防止超过预期值，最大最小值都可以程序设置，具体参照下面关于设置的介绍。

成功和失败的图片没有提供接口来替换，如果需要显示自定义的图片，上面也提供了方法。

当然你也将程序默认成功和失败的图片自己替换掉(在bundle中)，程序会根据图片的大小来自动计算Frame，所以图片大小也不受限制，但是图片名字必须与默认的保持一致。

第四类显示：在maskview(相当于蒙版)上显示view，高度自定义

+ (void)showWithView:(UIView *)view andDuration:(NSTimeInterval)duration;

随意显示，和上面最大的不同就是，它的frame需要使用者自己定义与计算，HUD只是提供一个蒙版，还有就是点击蒙版后的操作(隐藏，发送通知，或者什么也不做)

最后，也算第五类吧

显示系统的菊花到view的中间，view的扩展方法

/// 将DDProgressHUD无限循环动画添加到view, @return 返回DDProgressHUD实例

- (UIActivityIndicatorView *)showActivityView;

/// 将最顶层的ActivityView从父视图删除，如果添加了多次则只会删除最顶层! @return 找到并删除成功返回YES，否则NO

- (BOOL)hiddenActivityView;

DDProgressHUD的全局设置

设置有两种：

头文件里面的默认设置(宏定义)，相当于初始化，全局有效。位置：DDDefaultSetup.h头文件

程序提供的类方法，会覆盖之前的设置，全局有效。接口头文件：DDProgressHUD.h

简单看下视图和对应的名称，还有层级

maskview显示在window上

DDProgressHUD(下面简称hud)的backgroundView

大部分视图处于这一层级，比如上面提到的第一类、第二类、第三类显示的视图都在这个层级，下面示意图展示的是第二类：进度

3.1： 进度条的，有两个，黑色的为foregroundRing，灰色的为backgroundRing

3.2：显示的lbl

也可以根据上面显示类别和view的层级关系，分为以下几种

1 maskview，蒙版的设置

首先默认设置，一共有4个

/// 遮罩默认不透明度

#define kMaskViewAlpha 0.6f

/// 遮罩默认颜色

#define kMaskViewBackgroundColorRGB 0x999999

/// 默认展示动画时间

#define kShowAnimateDuration 0.2f

/// 默认隐藏动画时间

#define kDismissAnimateDuration 0.2f

前两个好理解，后面两个是展示maskview和隐藏时的动画时间，是对alpha做的动画。

对应类方法设置为：(void)setMaskviewColor:(UIColor *)color，颜色和透明度，一起设置。动画时间没有提供。

另外还有setMaskViewAutomaticHidden:，即点击蒙版后是否自动消失视图，即调用dismiss方法。无论YES或者NO，点击后都会发送一个通知static const NSNotificationName DDMaskViewDidClicked = @”DDMaskViewDidClicked”;

2 白色的背景设置

头文件默认设置

/// 圆角半径

#define kCornerRadius 10

#define kHudColor 0xF0F0F0

/// hud最大宽度与屏幕宽度比例

#define kMaxWidthRatioScreenWidth (2.0/3.0)

/// hud最大高度与屏幕高度比例

#define kMaxHeightRatioScreenHeight (2.0/3.0)

/// hud最小宽高比，避免hud显得太瘦，使用者可以通过将文本换行(

)来避免太胖

#define kMinimumWidthRatioHeight 0.95

/// 图片与文字之间的间隙(竖直方向)

#define kViewMargin 12

/// 与父视图间隙

#define kTopAndBottomMargin 16

/// 与父视图间隙

#define kLeftAndRightMargin 16

与屏幕的宽高比：主要是计算字符串文字信息是给的限定，防止超过限制，从而显得不美观

hud自身的宽高比：主要是避免显得太瘦，比如文字信息很短，就会现的很瘦，而太胖的话，可以对文字信息进行换行处理

还有间隙的设置：主要是针对hud的子view

类方法的设置：有的没有提供(比如宽高比，比如视图间隙)

/// 设置圆角，默认为10，具体参照：DDDefaultSetup.h为准

+ (void)setBackgroundViewCornerRadius:(CGFloat)radius;

/// 设置背景颜色，默认为0xF0F0F0，具体参照：DDDefaultSetup.h为准

+ (void)setBackgroundViewColor:(UIColor *)color;

/// 设置字体，默认为偏好设置字体

+ (void)setFont:(UIFont *)font;

3 弹窗、无限旋转的图片、进度圈的设置

共同的设置，即文字(lbl)字体：

类方法：setFont:，默认设置为跟随偏好设置的小标题大小变化[UIFont preferredFontForTextStyle:UIFontTextStyleSubheadline]

弹窗

默认：

/// 最长10秒，最短3秒

#define kDDMaxImageShowDuration 10.0f

#define kDDMinimumImageShowDuration 3.0f

/// 每个文字显示时间

#define kEveryWordShowDuration 0.2f

类方法：

+ (void)setMaxImageShowDuration:(CGFloat)duration;

+ (void)setMinimumImageShowDuration:(CGFloat)duration;

/// 默认每个文字0.2s，具体参照：DDDefaultSetup.h为准

+ (void)setEveryWordShowDuration:(CGFloat)duration;

主要用于计算弹窗显示时间长短

无限旋转的图片

默认：

/// 旋转一周所用的时间，控制旋转的速度

#define kOneRoundDuration 1.0f

类方法：多提供了旋转的图片设置，可以在这里设置，也可以直接将bundle里面的替换，替换后全局有效

/// 自定义旋转的图片

+ (void)setLoopImage:(UIImage *)image;

/// 控制旋转的速度：旋转一圈所用的时间，默认为1s，具体参照：DDDefaultSetup.h为准

+ (void)setLoopOneRingDuration:(CGFloat)duration;

进度圈

默认：

/// 进度圆环线半径大小

#define kRingRadius 25.0f

/// 进度圆环线宽度

#define kRingLineWidth 3.0f

/// 进度圆环颜色

#define kForegroundRingLineColorRGB 0x333333

#define kBackgroundRingLineColorRGB 0xE0E0E0

类方法：

/// 圆弧半径，默认为25，具体参照：DDDefaultSetup.h为准

+ (void)setForegroundRingRadius:(CGFloat)radius;

+ (void)setBackgroundRingRadius:(CGFloat)radius;

/// 圆弧线宽度，默认为3，具体参照：DDDefaultSetup.h为准

+ (void)setForegroundRingLineWidth:(CGFloat)width;

+ (void)setBackgroundRingLineWidth:(CGFloat)width;

/// 圆弧线颜色，默认为0xE0E0E0 0x333333，具体参照：DDDefaultSetup.h为准

+ (void)setForegroundRingLineColor:(UIColor *)color;

+ (void)setBackgroundRingLineColor:(UIColor *)color;