JHUD 是一個用於資料載入時全螢幕顯示的 HUD 元件,效果類似美團外賣載入資料時的樣子。原本想沿用美團的駱駝序列圖,但找不到合適素材,於是改從 preloaders.net 找了一個小齒輪動畫作為自訂動畫的示範。
專案地址:https://github.com/jinxiansen/JHUD

JHUD 繼承自 UIView,內部有三個子控件,由上而下分別是 UIView、UILabel 與 UIButton。子控件的 frame 以程式碼約束方式設定,細節見 UIView+JHUDAutoLayout 類別。
它提供五種動畫類型:
typedef NS_ENUM(NSUInteger, JHUDLoadingType) {
JHUDLoadingTypeCircle = 0,
JHUDLoadingTypeCircleJoin,
JHUDLoadingTypeDot,
JHUDLoadingTypeCustomAnimations,
JHUDLoadingTypeFailure,
};
前三種由 JHUDLoadingAnimationView 實作,這個 view 在 show 時被加到上述三控件中的 UIView 上。使用方式:
self.hudView.messageLabel.text = @"Hello, this is a circle animation"; [self.hudView showAtView:self.view hudType:JHUDLoadingTypeCircle];



JHUDLoadingTypeCustomAnimations 用於自訂動畫,由 UIImageView 呈現。這個 imageView 同樣加在上述的 UIView 上,只是在顯示前三種動畫時處於隱藏狀態。
使用時需傳入 customAnimationImages(NSArray)作為序列圖陣列。若動畫尺寸不合適,可透過 indicatorViewSize 調整。
NSMutableArray *images = [NSMutableArray array];
for (int index = 0; index <= 19; index++) {
NSString *imageName = [NSString stringWithFormat:@"%d.png", index];
[images addObject:[UIImage imageNamed:imageName]];
}
self.hudView.indicatorViewSize = CGSizeMake(60, 60);
self.hudView.customAnimationImages = images;
self.hudView.messageLabel.text = @"無人問我粥可溫,無人與我共黃昏";
[self.hudView showAtView:self.view hudType:JHUDLoadingTypeCustomAnimations];

最後一個 JHUDLoadingTypeFailure 適用於資料取得失敗或網路異常的情況。
self.hudView.indicatorViewSize = CGSizeMake(150, 150); self.hudView.messageLabel.text = @"Failed to get data, please try again later"; [self.hudView.refreshButton setTitle:@"Refresh?" forState:UIControlStateNormal]; self.hudView.customImage = [UIImage imageNamed:@"nullData"]; [self.hudView showAtView:self.view hudType:JHUDLoadingTypeFailure];

注意:indicatorViewSize 在前三種動畫類型中不可修改,因為動畫的 frame 與軌跡已經寫死。
載入提示看似簡單,但有幾個細節會直接影響使用者觀感:
原始碼:https://github.com/jinxiansen/JHUD