您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

MJRefresh 實作筆記:下拉刷新、上拉載入,還能換 GIF 動畫

編輯:iOS 相關資訊

MJRefresh 是國內 iOS 圈最常用的下拉刷新庫之一,API 設計得相當直白。以下記錄我把它接進專案的完整流程,包含如何用 GIF 動畫取代預設菊花,以及如何微調頭尾元件的位置。

步驟一:取得 MJRefresh

到 GitHub 下載最新版的 MJRefresh,把原始碼拖進專案(或直接用 CocoaPods 安裝 MJRefresh),並加入必要的 framework。

步驟二:建立 tableView 並掛上頭尾

_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],否則動畫會一直轉。

步驟三:準備 GIF 的每一幀

- (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 裡調整,依設計稿數值改即可。

幾個實務提醒

  • 覆寫 MJRefresh 內部類別並非升級友善的做法。更安全的替代方案是透過 MJRefresh 提供的公開屬性(如 gifView、stateLabel、mj_w 等)在外部設定,或在 CocoaPods 中用 category 擴充,避免整包更新後你的改動被覆蓋。
  • 記得呼叫 endRefreshing。忘記收尾是新手最常見的問題,UI 會停在「正在刷新」狀態再也回不去。
  • 「沒有更多了」要主動告知。資料已全部載入時呼叫 [_tableView.footer noticeNoMoreData],否則使用者會一直上拉觸發空請求。
  • GIF 幀數與解析度要節制。每張幀圖都會被解碼進記憶體,幀數多、尺寸大時建議改用 UIImageView animationImages 或壓縮過的 webp,避免列表捲動時出現記憶體警告。

更多可調項目建議直接看 MJRefresh 在 GitHub 上的說明文件,作者把每個狀態與屬性都整理得很完整。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved