做過行動端的人都同意,列表是最常被使用的元件。Apple 的 UITableView 設計其實相當完善,簡單易用、擴充性強。但只要展示邏輯稍微固定一點,你就會感覺到繁瑣:
於是把常見模式包成一個父類別 ELTableViewController(名字取自 EGORefreshTableHeaderView 與 LoadMoreTableFooterView 的縮寫),把重複的部分收攏,把變動的部分用 block 開放給子類。
原始碼放在自己的 GitHub 上,內含一個範例程式與三個必備元件:EGORefreshTableHeaderView、LoadMoreTableFooterView(改寫版,原版無法適應任意高度),以及 Apple 官方的異步下載範例 IconDownloader。最後這個只適合載入類似社群頭像的小圖,不建議抓大圖,因為它連快取都沒有——大圖請用 SDWebImage 這類方案。
@interface ELTableViewController : UIViewController <
UITableViewDelegate,
UITableViewDataSource,
EGORefreshTableHeaderDelegate,
LoadMoreTableFooterDelegate,
IconDownloaderDelegate
>
// 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;
以最關鍵的三個方法為例,找不到對應 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 預設實作,思路是一樣的。