您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發筆記 13:UITableView 封裝——下拉刷新、上拉載入與圖片異步載入

編輯:iOS 開發綜合

做過行動端的人都同意,列表是最常被使用的元件。Apple 的 UITableView 設計其實相當完善,簡單易用、擴充性強。但只要展示邏輯稍微固定一點,你就會感覺到繁瑣:

  1. 使用頻率高到驚人,同一套模式要寫很多次;
  2. 它很少只是「顯示資料」,通常還要跟著下拉刷新、上拉載入更多;
  3. 幾乎一定要跟網路與圖片下載打交道;
  4. MVC 是 iOS 的慣例,於是每個列表都要實作一堆 delegate / dataSource 協議,寫第一次還好,寫第五次就索然無味。

於是把常見模式包成一個父類別 ELTableViewController(名字取自 EGORefreshTableHeaderView 與 LoadMoreTableFooterView 的縮寫),把重複的部分收攏,把變動的部分用 block 開放給子類。

一、封裝內容

  1. 內嵌下拉刷新(EGORefreshTableHeaderView)與上拉載入更多(LoadMoreTableFooterView)。
  2. 內部實作 UITableViewDataSource 與 UITableViewDelegate,自訂邏輯以 block 對外開放。
  3. 內部實作上述兩個自訂元件的回調協議,同樣以 block 對外。
  4. 內部處理兩個元件與 UITableView 互動所需的 UIScrollViewDelegate。
  5. 內建圖片異步下載(可選)。

原始碼放在自己的 GitHub 上,內含一個範例程式與三個必備元件:EGORefreshTableHeaderView、LoadMoreTableFooterView(改寫版,原版無法適應任意高度),以及 Apple 官方的異步下載範例 IconDownloader。最後這個只適合載入類似社群頭像的小圖,不建議抓大圖,因為它連快取都沒有——大圖請用 SDWebImage 這類方案。

二、因為協議都已實作,使用時不必再設定

@interface ELTableViewController : UIViewController <
    UITableViewDelegate,
    UITableViewDataSource,
    EGORefreshTableHeaderDelegate,
    LoadMoreTableFooterDelegate,
    IconDownloaderDelegate
>

三、對外開放的 block

// UITableView delegate
typedef UITableViewCell* (^cellForRowAtIndexPathDelegate)(UITableView *, NSIndexPath *);
typedef CGFloat (^heightForRowAtIndexPathDelegate)(UITableView *, NSIndexPath *);
typedef void (^didSelectRowAtIndexPathDelegate)(UITableView *, NSIndexPath *);

// 刷新與載入更多
typedef void (^refreshDataSourceFunc)(void);
typedef void (^loadMoreDataSourceFunc)(void);
typedef void (^refreshDataSourceCompleted)(void);
typedef void (^loadMoreDataSourceCompleted)(void);

// 圖片異步載入
typedef void (^loadImagesForVisiableRowsFunc)(void);
typedef void (^appImageDownloadCompleted)(NSIndexPath *);

這些 block 以 copy 修飾的屬性對外公開:

@property (nonatomic, copy) cellForRowAtIndexPathDelegate   cellForRowAtIndexPathDelegate;
@property (nonatomic, copy) heightForRowAtIndexPathDelegate  heightForRowAtIndexPathDelegate;
@property (nonatomic, copy) didSelectRowAtIndexPathDelegate  didSelectRowAtIndexPathDelegate;
@property (nonatomic, copy) refreshDataSourceFunc            refreshDataSourceFunc;
@property (nonatomic, copy) loadMoreDataSourceFunc           loadMoreDataSourceFunc;
@property (nonatomic, copy) refreshDataSourceCompleted       refreshDataSourceCompleted;
@property (nonatomic, copy) loadMoreDataSourceCompleted      loadMoreDataSourceCompleted;
@property (nonatomic, copy) loadImagesForVisiableRowsFunc    loadImagesForVisiableRowsFunc;
@property (nonatomic, copy) appImageDownloadCompleted        appImageDownloadCompleted;

下拉、上拉與圖片下載都是「可選」的,實例化時就能決定要不要開;圖片那塊只要不實作對應 block,就不會造成額外負擔:

- (id)initWithRefreshHeaderViewEnabled:(BOOL)enableRefreshHeaderView
              andLoadMoreFooterViewEnabled:(BOOL)enableLoadMoreFooterView;

- (id)initWithRefreshHeaderViewEnabled:(BOOL)enableRefreshHeaderView
              andLoadMoreFooterViewEnabled:(BOOL)enableLoadMoreFooterView
                        andTableViewFrame:(CGRect)frame;

四、內部如何把 delegate 轉成 block

以最關鍵的三個方法為例,找不到對應 block 時直接丟例外,讓缺少實作的問題在開發階段就浮現:

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    if (nil == self.dataSource) { return 0; }
    return [self.dataSource count];
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    if (!self.cellForRowAtIndexPathDelegate) {
        @throw [NSException exceptionWithName:@"Framework Error"
                                      reason:@"Must be setting cellForRowAtIndexPathBlock for UITableView"
                                    userInfo:nil];
    }
    return self.cellForRowAtIndexPathDelegate(tableView, indexPath);
}

捲動時則依方向分派給上拉或下拉元件:

- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
    CGPoint pt = scrollView.contentOffset;
    if (self.currentOffsetPoint.y < pt.y) {
        [self.loadMoreFooterView loadMoreScrollViewDidScroll:scrollView];
    } else {
        [self.refreshHeaderView egoRefreshScrollViewDidScroll:scrollView];
    }
}

- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate {
    CGPoint pt = scrollView.contentOffset;
    if (self.currentOffsetPoint.y < pt.y) {
        [self.loadMoreFooterView loadMoreScrollViewDidEndDragging:scrollView];
    } else {
        [self.refreshHeaderView egoRefreshScrollViewDidEndDragging:scrollView];
    }
    if (!decelerate && self.loadImagesForVisiableRowsFunc) {
        self.loadImagesForVisiableRowsFunc();
    }
}

觸發刷新時先呼叫使用者的資料來源 block,再用 dispatch_after 模擬一段延遲後通知完成:

-(void)egoRefreshTableHeaderDidTriggerRefresh:(EGORefreshTableHeaderView *)view {
    if (self.refreshDataSourceFunc && self.refreshDataSourceCompleted) {
        self.refreshDataSourceFunc();

        double delayInSeconds = 3.0;
        dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, delayInSeconds * NSEC_PER_SEC);
        dispatch_after(popTime, dispatch_get_main_queue(), self.refreshDataSourceCompleted);
    }
}

五、怎麼用

寫一個繼承自 ELTableViewController 的子類,覆寫 initBlocks,把每個 block 填上自己的邏輯。注意 block 內若需要用到 self,要用 __block 修飾的暫存變數,避免循環引用:

- (void)initBlocks {
    __block TestViewController *blockedSelf = self;

    self.refreshDataSourceFunc = ^{
        blockedSelf.dataSource = [NSMutableArray array];
        [blockedSelf.dataSource addObject:@"refreshDataSourceBlock_1"];
        blockedSelf.isRefreshing = YES;
        [self.tableView reloadData];
    };

    self.refreshDataSourceCompleted = ^{
        blockedSelf.isRefreshing = NO;
        [blockedSelf.loadMoreFooterView loadMoreScrollViewDataSourceDidFinishedLoading:self.tableView];
    };

    self.cellForRowAtIndexPathDelegate = ^(UITableView *tableView, NSIndexPath *indexPath) {
        static NSString *cellIdentifier = @"cellIdentifier";
        UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
        if (!cell) {
            cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault
                                         reuseIdentifier:cellIdentifier] autorelease];
        }
        cell.textLabel.text = [blockedSelf.dataSource objectAtIndex:indexPath.row];
        return cell;
    };

    self.heightForRowAtIndexPathDelegate = ^(UITableView *tableView, NSIndexPath *indexPath) {
        return 60.0f;
    };
}

這樣一層封裝下來,新增一個列表頁時只要專心寫「資料怎麼來、cell 怎麼擺」,其餘刷新、分頁、圖片載入的瑣事都由父類接手。以今天的標準來看,這套寫法可以對應成 UITableViewController 加 UIRefreshControl、SDWebImage 與 UITableViewDataSource 的 protocol 預設實作,思路是一樣的。

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