UITableView 是我們再熟悉不過的控件了,它的 delegate 和 data source 回調不知寫了多少遍,自然也難免遇到 cell 高度計算的難題。UITableView 詢問 cell 高度的方式主要有兩種。
第一種,適用於所有 cell 高度固定的場景,直接設置:
self.tableView.rowHeight = 88;
這行代碼指定了一個所有 cell 高度均為 88 的表格。對於定高需求的列表,強烈建議採用這種方式,以省去不必要的高度計算與調用。rowHeight 的默認值是 44,這也是空 UITableView 看起來那個樣子的原因。
第二種,是實現 UITableViewDelegate 中的:
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { // return xxx }
需要注意的是,一旦實現了這個方法,rowHeight 的設置便會失效。因此,它適用於擁有多種 cell 高度的表格。
這個屬性早在 iOS 7 就已出現,文檔對它的描述是:
If the table contains variable height rows, it might be expensive to calculate all their heights when the table loads. Using estimation allows you to defer some of the cost of geometry calculation from load time to scrolling time.
聽上去頗有道理。我們知道,UITableView 本質上是個 UIScrollView,和使用普通的 UIScrollView 一樣,加載時必須先確定 contentSize,它才能依據自身的 bounds、contentInset、contentOffset 等屬性判斷能否滑動以及滾動條的長度。而 UITableView 在初始階段並不知道自己將被填充多少內容,於是一邊詢問 data source 個數並創建 cell,一邊詢問 delegate 這些 cell 應有的高度,這就導致它在加載時把多餘的計算浪費在了屏幕外的 cell 上。與 rowHeight 類似,設置估算高度也有兩種方式:
self.tableView.estimatedRowHeight = 88; // or - (CGFloat)tableView:(UITableView *)tableView estimatedHeightForRowAtIndexPath:(NSIndexPath *)indexPath { // return xxx }
不同的是,即便面對種類各異的 cell,我們依然可以使用簡單的 estimatedRowHeight 屬性賦值,只要整體估算值大致貼近即可。比如約有一半 cell 高 44、一半高 88,那麼估算一個 66 就基本符合預期。
說完了估算高度的基本用法,可以開始吐槽了:設置估算高度後,contentSize.height 會按「cell 估算值 × cell 個數」計算,這使得滾動條大小處於不穩定狀態。contentSize 會隨著滾動逐步把估算高度替換為真實高度,肉眼可見滾動條突然變化甚至「跳躍」。若再碰上設計不佳的下拉刷新或上拉加載控件,或是 KVO 了 contentSize、contentOffset 屬性,表格滑動時就更容易抖動。估算高度的初衷固然是好的——讓加載更快;但憑什麼要以犧牲滑動的流暢性為代價呢?用戶對進入頁面時多出的零點幾秒加載時間往往無感,卻能明顯體驗到滑動時實時計算高度帶來的卡頓。個人覺得,還不如一開始就把高度算好(更過分的是 iOS 8,即使都算好了它也會邊滑邊算)。
具有動態高度內容的 cell 一直是個令人頭疼的問題,比如聊天氣泡的 cell。在 frame 布局的時代,通常得靠數據內容反推高度:
CGFloat height = textHeightWithFont() + imageHeight + topMargin + bottomMargin + ...;
供 UITableViewDelegate 調用時,它很可能是一個 cell 的類方法:
@interface BubbleCell : UITableViewCell + (CGFloat)heightWithEntity:(id)entity; @end
各種「魔法」 margin,再加上與屏幕寬度的耦合,讓人頭大。
進入 AutoLayout 時代後情況好了不少,系統提供了 -systemLayoutSizeFittingSize: 這類 API,只要在 contentView 中設置好約束,就能算出準確的值。缺點是計算速度終究不如手算,而且它是一個實例方法,需要維護專門為計算高度而生的 template layout cell,同時還要求開發者對約束相當熟練——必須保證 contentView 內部上下左右各個方向都有約束支撐,一旦設置不合理,算出的高度就會是 0。
這裡還不得不提一個 UILabel 的老毛病:當行數大於 0 時,必須指定 preferredMaxLayoutWidth,它才知道何時該折行。這無疑是個「雞生蛋、蛋生雞」的難題——UILabel 需要知道 superview 的寬度才能折行,而 superview 的寬度又依賴子 view 寬度的累加才能確定。這個問題直到 iOS 8 才得以自動解決。
回到正題,iOS 8 的 WWDC 推出了 self-sizing cell 的概念,旨在讓 cell 自己負責自己的高度計算,無論使用 frame 布局還是 auto 布局都能享受這一特性:

這個特性首先要求系統為 iOS 8,若最低支持版本低於 8,還得為老版本單獨寫一套老式的算高邏輯(略顯尷尬)。不過用到的 API 並非新面孔:
self.tableView.estimatedRowHeight = 213; self.tableView.rowHeight = UITableViewAutomaticDimension;
這裡又不得不吐槽:自動計算 rowHeight 和 estimatedRowHeight 到底有什麼仇?如果不設置估算高度,自動算高就會失效。
PS:iOS 8 中 rowHeight 的默認值已被設為 UITableViewAutomaticDimension,所以第二行代碼可以省略。
問題:這種自動算高在 push 到下一頁面或轉屏時,偶爾會出現高度特別詭異的情況,好在後續版本已修復。
相同的代碼在 iOS 7 和 iOS 8 上滑動順暢度天差地別,iOS 8 莫名地卡。很大一部分原因在於 iOS 8 的算高機制截然不同,以下是我做的小測試:

研究後發現,這麼多次額外計算主要源於以下原因:
不開啟高度估算時,UITableView 上來就要對所有 cell 調用算高來確定 contentSize;dequeueReusableCellWithIdentifier:forIndexPath: 相比不帶「forIndexPath」的版本,會多調用一次高度計算;iOS 7 算完高度後有「緩存」機制,不會重複計算,而 iOS 8 無論何時都會重新計算 cell 高度。
iOS 8 把高度計算搞成這樣,從 WWDC 也能找到些解釋:cell 被認為隨時都可能改變高度(比如用戶在設置中調整了動態字體大小),所以每次滑動出現後都得重新計算。
說了這麼多,究竟有沒有既能免去算高煩惱、又能保證滑動順暢、還能兼容 iOS 6 的一站式方案呢?
使用 UITableView+FDTemplateLayoutCell 無疑是解決算高問題的最佳實踐之一:它既具備 iOS 8 self-sizing 簡潔的 API,又能達到 iOS 7 般流暢的滑動效果,還保持了最低支持 iOS 6。使用起來大致如下:
#import- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByIndexPath:indexPath configuration:^(id cell) { // 配置 cell 的數據源,和 "cellForRow" 干的事一致,比如: cell.entity = self.feedEntities[indexPath.row]; }]; }
寫完上面的代碼後,你便已經用到了:
與每個 ReuseID 一一對應的 template layout cell
這個 cell 只為參與高度計算而存在,不會真正顯示到屏幕上;它由 UITableView 的 -dequeueCellForReuseIdentifier: 方法懶加載創建並保存,因此要求該 ReuseID 必須已註冊到 UITableView 中——要麼是 Storyboard 裡的原型 cell,要麼通過 -registerClass:forCellReuseIdentifier: 或 -registerNib:forCellReuseIdentifier: 註冊。
根據 autolayout 約束自動計算高度
採用了系統早在 iOS 6 就提供的 API:-systemLayoutSizeFittingSize:。
基於 index path 的高度緩存機制
算出的高度會自動緩存,滑動時每個 cell 真正的高度計算只會發生一次,後續的高度詢問都會命中緩存,大幅減少了多餘計算。
自動的緩存失效機制
不必擔心數據源變化引發緩存失效。當調用 -reloadData、-deleteRowsAtIndexPaths:withRowAnimation: 等任何觸發 UITableView 刷新機制的數據時,已有的高度緩存會以最小的代價失效。例如刪除 indexPath 為 [0:5] 的 cell 時,[0:0]~[0:4] 的緩存不受影響,而 [0:5] 之後的所有緩存值都會整體前移一位。這套機制對 UITableView 的 9 個公有 API 都做了分別處理,以確保沒有一次多餘的高度計算。
預緩存機制
預緩存會在 UITableView 空閒時執行,提前計算並緩存那些尚未顯示到屏幕的 cell,整個過程用戶完全無感知。這樣一來,完整列表的高度計算既不發生在加載時,也不發生在滑動時,兼顧了加載速度與滑動流暢性。
在設計這套工具的 API 時,我們斟酌了很長時間:既要功能強大,又要接口精簡,一行調用背後其實隱藏著大量工作。
這套緩存機制對滑動的提升究竟有多大?除了肉眼可感知外,我還做了一個小測試:一個擁有 54 個內容與高度各異 cell 的 table view,從頭滑到尾、再從尾滑回頭,在 iOS 8、iPhone 6 上,用 Time Profiler 監測算高函數的耗時:
未使用緩存 API、未開啟估算,共耗時 877 ms:

使用緩存 API、開啟估算,共耗時 77 ms:

測試數據的精度暂且不去糾結,光是量級就相差了一個數量級,說實話連我自己都沒想到差距會這麼大。
同時,這款工具也順手解決了 -preferredMaxLayoutWidth 的問題:在計算高度前,向 contentView 添加一條與 table view 等寬的寬度約束,強行讓 contentView 內部的控件得知父 view 的寬度,再反推自己被外界約束的寬度,從而破解「雞生蛋、蛋生雞」的困局。這裡技巧性頗強,就不展開細說了。下面聊聊如何利用 RunLoop 實現預緩存。
FDTemplateLayoutCell 的高度預緩存是一項優化功能,它要求頁面處於空閒狀態時才執行計算——用戶正在滑動列表時顯然不該被計算任務打擾。一般來說,這需要耦合 UITableView 的滑動狀態,但這種做法既不優雅,又可能破壞外部的 delegate 結構。所幸我們還有 RunLoop 這件利器,理解其運行機制後,用很少的代碼就能實現。
在用戶滑動 UIScrollView 時,RunLoop 會切換到 UITrackingRunLoopMode,以接收滑動手勢、處理滑動事件(包括減速與彈簧效果);此時其他 Mode(NSRunLoopCommonModes 這一組合 Mode 除外)下的事件都會暫停,以保證滑動優先處理,這也是 iOS 滑動順暢的重要原因之一。而當 UI 沒有滑動時,默認 Mode 是 NSDefaultRunLoopMode(等同 CF 中的 kCFRunLoopDefaultMode),也就是 CF 定義的「空閒狀態 Mode」——當用戶什麼都不點、也沒有網絡 IO 時,就處於這個 Mode 下。
註冊 RunLoopObserver 可以監測當前 RunLoop 的運行狀態,並在狀態機切換時收到通知:
RunLoop 開始 / RunLoop 即將處理 Timer / RunLoop 即將處理 Source / RunLoop 即將進入休眠 / RunLoop 即將從休眠中被喚醒 / RunLoop 退出。
由於「預緩存高度」需要在最無感知的時刻進行,因此應同時滿足兩個條件:RunLoop 處於「空閒」的 Mode,且這一次迭代已處理完所有事件、馬上就要休眠。使用 CF 帶 block 的註冊函數能讓代碼更簡潔:
CFRunLoopRef runLoop = CFRunLoopGetCurrent(); CFStringRef runLoopMode = kCFRunLoopDefaultMode; CFRunLoopObserverRef observer = CFRunLoopObserverCreateWithHandler (kCFAllocatorDefault, kCFRunLoopBeforeWaiting, true, 0, ^(CFRunLoopObserverRef observer, CFRunLoopActivity _) { // TODO here }); CFRunLoopAddObserver(runLoop, observer, runLoopMode);
在其中的 TODO 位置,便可開始任務的收集與分發,當然也別忘了在合適的時機移除這個 observer。
假設列表有 20 個 cell,加載後展示了前 5 個,那麼開啟估算後 table view 只計算了這 5 個的高度,剩下的 15 個就是「預緩存」的任務。我們並不希望這 15 個計算在同一個 RunLoop 迭代中同步執行,否則會卡頓 UI,因此應把它們分別打散到 15 個 RunLoop 迭代中執行,這就需要手動向 RunLoop 添加 Source 任務(由應用發起並處理的是 Source 0 任務)。Foundation 層沒有直接構建 RunLoopSource 的 API,卻提供了一個既熟悉又陌生的間接接口:
- (void)performSelector:(SEL)aSelector onThread:(NSThread *)thr withObject:(id)arg waitUntilDone:(BOOL)wait modes:(NSArray *)array;
這個方法會創建一個 Source 0 任務,分發到指定線程的 RunLoop 中,在給定的 Mode 下執行;若指定的 RunLoop 正處於休眠,則會喚醒它來處理事件。於是,我們用一個可變數組裝載所有待「預緩存」的 index path,每次 RunLoopObserver 回調時取出第一個任務分發出去:
NSMutableArray *mutableIndexPathsToBePrecached = self.fd_allIndexPathsToBePrecached.mutableCopy; CFRunLoopObserverRef observer = CFRunLoopObserverCreateWithHandler(kCFAllocatorDefault, kCFRunLoopBeforeWaiting, true, 0, ^(CFRunLoopObserverRef observer, CFRunLoopActivity _) { if (mutableIndexPathsToBePrecached.count == 0) { CFRunLoopRemoveObserver(runLoop, observer, runLoopMode); CFRelease(observer); // 注意釋放,否則會造成內存洩露 return; } NSIndexPath *indexPath = mutableIndexPathsToBePrecached.firstObject; [mutableIndexPathsToBePrecached removeObject:indexPath]; [self performSelector:@selector(fd_precacheIndexPathIfNeeded:) onThread:[NSThread mainThread] withObject:indexPath waitUntilDone:NO modes:@[NSDefaultRunLoopMode]]; });
如此一來,每個任務都被分配到下一個「空閒」的 RunLoop 迭代中執行;期間一旦有滑動事件開始,Mode 便切換為 UITrackingRunLoopMode,所有「預緩存」任務的分發與執行都會自動暫停,最大程度保障滑動流暢。
PS:預緩存功能因為與下拉刷新存在衝突、且收益不明顯,最終已被廢棄。
如果你覺得這款工具對你有幫助,集成到工程裡也十分簡單。使用 CocoaPods:
pod search UITableView+FDTemplateLayoutCell
撰寫本文時的最新版本為 1.2,它移除了上一版的一些「黑魔法」,並新增了預緩存功能。歡迎使用與支持這個工具,遇到 bug 請隨時反饋。
GitHub 地址:https://github.com/forkingdog/UITableView-FDTemplateLayoutCell