靈活、可高度自定義的——Progress進度圈、彈窗、加載進度、小菊花

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

簡單看下視圖和對應的名稱，還有層級

1. maskview顯示在window上
2. DDProgressHUD（下面簡稱hud）的backgroundView
3. 大部分視圖處於這一層級，好比上面提到的第一類、第二類、第三類顯示的視圖都在這個層級，下面示意圖展現的是第二類：進度
   • 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顯得太瘦，使用者能夠經過將文本換行(\n\r)來避免太胖
#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;

github地址：https://github.com/mddios/DDProgressHUD ，已支持CocoaPods：pod 'MDDProgressHUD',注意前面是MDD，不是DD（被別人佔用）
若是幫到了你，給顆星吧！