MJRefresh 是國內 iOS 圈最常用的下拉刷新庫之一,API 設計得相當直白。以下記錄我把它接進專案的完整流程,包含如何用 GIF 動畫取代預設菊花,以及如何微調頭尾元件的位置。
到 GitHub 下載最新版的 MJRefresh,把原始碼拖進專案(或直接用 CocoaPods 安裝 MJRefresh),並加入必要的 framework。
_tableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 0, MCAPPWidth, MCAPPHeight - 64)]; _tableView.backgroundColor = myClearColor; _tableView.separatorStyle = UITableViewCellSeparatorStyleNone; _tableView.delegate = self; _tableView.dataSource = self; _tableView.showsVerticalScrollIndicator = NO; _tableView.scrollsToTop = YES; [self.view addSubview:_tableView]; // 加上 GIF 動畫的頭與尾 [_tableView addGifHeaderWithRefreshingTarget:self refreshingAction:@selector(loadData)]; [_tableView addGifFooterWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; [self gif];
loadData 是你下拉觸發時要呼叫的網路請求方法,loadMoreData 則是上拉載入更多時呼叫的方法。資料抓回來並 reload 完 tableView 之後,記得呼叫 [_tableView.header endRefreshing] 與 [_tableView.footer endRefreshing],否則動畫會一直轉。
- (void)gif 做的事是把序列圖幀讀進陣列,分別餵給不同狀態:
- (void)gif {
NSMutableArray *idleImages = [NSMutableArray array];
// 閒置狀態(尚未觸發)播放的動畫
for (NSUInteger i = 1; i <= 5; i++) {
UIImage *image = [UIImage imageNamed:
[NSString stringWithFormat:@"img_loading-%lu.png", (unsigned long)i]];
[idleImages addObject:image];
}
[_tableView.gifHeader setImages:idleImages forState:MJRefreshHeaderStateIdle];
_tableView.gifFooter.refreshingImages = idleImages;
_tableView.gifHeader.updatedTimeHidden = YES;
// 即將刷新狀態:手指放開就會觸發刷新
NSMutableArray *refreshingImages = [NSMutableArray array];
for (NSUInteger i = 1; i <= 5; i++) {
UIImage *image = [UIImage imageNamed:
[NSString stringWithFormat:@"img_loading-%lu.png", (unsigned long)i]];
[refreshingImages addObject:image];
}
[_tableView.gifHeader setImages:refreshingImages forState:MJRefreshHeaderStatePulling];
}
這裡有個常被忽略的設計意圖:MJRefresh 的 header 有多種狀態(Idle、Pulling、Refreshing 等),可以為不同狀態指定不同的動畫。「即將刷新」與「正在刷新」給不同的視覺回饋,使用者會更容易理解「放手才會真的刷新」。
預設配置不一定符合設計稿,這時覆寫對應類別的 layoutSubviews 即可。以下以 footer 為例:
MJRefreshGifFooter.m
- (void)layoutSubviews {
[super layoutSubviews];
// 指示器(GIF 圖)的 frame
self.gifView.frame = CGRectMake(self.bounds.origin.x + 20,
self.bounds.origin.y + 15,
self.bounds.size.width / 2,
self.bounds.size.height / 2);
if (self.stateHidden) {
self.gifView.contentMode = UIViewContentModeCenter;
} else {
self.gifView.contentMode = UIViewContentModeScaleAspectFit;
self.gifView.mj_w = self.mj_w * 0.5 - 90;
}
}
MJRefreshFooter.m
- (void)layoutSubviews {
[super layoutSubviews];
self.loadMoreButton.frame = self.bounds;
self.loadMoreButton.hidden = YES;
// Label 的 frame
self.stateLabel.frame = CGRectMake(self.bounds.origin.x,
self.bounds.origin.y + 15,
self.bounds.size.width,
self.bounds.size.height / 2);
self.noMoreLabel.frame = self.bounds;
}
header 的 GIF 與 Label 位置同理,都在對應類別的 layoutSubviews 裡調整,依設計稿數值改即可。
gifView、stateLabel、mj_w 等)在外部設定,或在 CocoaPods 中用 category 擴充,避免整包更新後你的改動被覆蓋。[_tableView.footer noticeNoMoreData],否則使用者會一直上拉觸發空請求。UIImageView animationImages 或壓縮過的 webp,避免列表捲動時出現記憶體警告。更多可調項目建議直接看 MJRefresh 在 GitHub 上的說明文件,作者把每個狀態與屬性都整理得很完整。