UITableView 是 iOS 最常見的列表控制項,但每個頁面幾乎都要重複實作 delegate、datasource、下拉刷新、上提載入與圖片非同步下載。把這些固定流程封裝成 ELTableViewController,可以讓業務端只專注在資料與 cell 內容。
ELTableViewController 內建 UITableViewDataSource 與 UITableViewDelegate,也把 EGORefreshTableHeaderView、LoadMoreTableFooterView 的 callbacks 整合進來。對外則用 block 開放 cellForRowAtIndexPath、heightForRowAtIndexPath、didSelectRowAtIndexPath、refreshDataSourceFunc、loadMoreDataSourceFunc 等自訂邏輯。
使用 block 可避免額外宣告 delegate 方法,讓呼叫端在建立 controller 時就能決定每個列的樣式與資料來源。對於下拉刷新與上提載入,也能用 refreshDataSourceFunc 與 loadMoreDataSourceFunc 直接指定行為。
typedef void (^refreshDataSourceFunc)(void); typedef void (^loadMoreDataSourceFunc)(void);
建立新的 view controller 並繼承 ELTableViewController,然後覆寫 initBlocks。在 initBlocks 中設定 cellForRowAtIndexPathDelegate、heightForRowAtIndexPathDelegate、refreshDataSourceFunc、loadMoreDataSourceFunc 等 block。若需要非同步圖片,也可設定 loadImagesForVisiableRowsFunc 與 appImageDownloadCompleted。
封裝後仍要注意 block 的 capture 問題,避免 self 被 block Retention 造成循環引用。若使用 __block 或 weak 方式取得 self,也要確保在 block 執行期間 self 尚未被釋放。下拉刷新與上提載入的完成狀態,也要記得通知元件結束 loading 動畫。