如何優雅的對UITableView進行解耦

scratXu發表於2018-03-19
UIView解耦

在本文之前筆者已經將相關程式碼開源到 GitHub 上並新增了 CocoaPods 的支援，歡迎大家下載檢視：STDTableView，下面進入正題：

首先說一下本篇文章的背景，公司的一個專案中需要用到一個動態編輯的表單頁面，樣式如下圖所示：

動態編輯表單
該表單頁面在專案中多處應用，且部分頁面需要支援定製，經過分析後大概可總結出以下的幾點要求：

  • cell 需支援鍵盤輸入，並需要對輸入做合法性驗證；
  • cell 需要可以指定輸入的資料型別及提交時的資料型別；
  • cell 需支援各類彈出式選擇器（時間選擇、條目選擇、聯動選擇）；
  • cell 需支援push到下個介面進行負責資料的選擇；
  • 表單需要支援在編輯時動態新增或者刪除條目；
  • 表單需要支援指定必填項與非必填項；
  • 表單需要支援指定不可編輯的條目；
  • 表單需要支援通過網路載入回的資料進行初始化； ...

以往專案中的 tableView 結構已經無法滿足這種型別的需求了，特別是對 cell 內部事件處理，因而才萌生了對 UITableView 進行封裝的念頭，STDTableView 也是在這種情況下誕生的，筆者基於這個庫完美的實現了上述的需求，並全線推行到公司的專案中。下面來聊一下 STDTableView 的實現思路：

可以說 UITableView 是 iOS 開發中最常用的元件之一,關於它的介面及基本使用方法相信大家也都已經爛熟於胸，本文主要探討的是如何在業務爆炸的情況下避免 viewController 變得臃腫不堪，以及如何更優雅簡潔的實現 UITableView 的相關呼叫。

首先，先簡單的列舉一下日常開發中經常碰到的幾種情況：

  1. 一個列表有多個 section，每個 section 中的 cell 結構不同；
  2. 一個列表只有一個 section，但是 section 中存在多種 cell 結構；
  3. 需要在 viewController 中響應 cell 內部的點選事件；

其中，針對上面的1、2兩點，如果不注意的話經常會寫出如下風格的程式碼：

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    UITableViewCell *cell = nil;

    if (indexPath.section == 0) {
        cell = xxx;
    } else if (indexPath.section == 1) {
        cell = xxx;
    } else {
        cell = xxx;
    }

    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    if (indexPath.section == 0) {
        xxx
    } else if (indexPath.section == 1) {
        xxx
    } else {
        xxx
    }
}

複製程式碼

相信大家在剛開始寫 tableView 的時候對上面的程式碼都深有體會，單一型別的 cell 還好，但是如果後面需要增加不同的型別，或者根據不同的 row 跳轉到不同的頁面的話，這坨程式碼會慢慢的龐大起來，最後可能自己看著都不想維護！

那麼有什麼方式來優化這個問題嗎？我們不妨先從以下幾點著手：

  1. 建立一個 dataAdapter 類，將 cell 的資料及基本配置如：cellReuseIdentifier、cellHeight、cellType 等儲存起來做為cell的資料來源；
  2. 將 cell 的資料配置及選中回撥封裝在自身，然後通過一個如 loadContent 以及 selectedEvent 的方法在 cellForRowAtIndexPath 和 didSelectRowAtIndexPath 中呼叫；
  3. 將 dataSource 從 viewController 中剝離；

於是我們的程式碼便可以變成如下的形式，viewController中也不需要每次都重新寫資料來源方法：

//獨立的資料來源
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    STDTableViewItem *item = [self itemAtIndexPath:indexPath];
    
    STDTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:item.cellReuseIdentifier];
        
    [cell loadContent];
    
    return cell;
}

// viewController 中的 delegate 回撥
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
	[(STDTableViewCell *)[tableView cellForRowAtIndexPath:indexPath] selectedEvent];
}
複製程式碼

然而這個方式也存在一個問題，那就是 dataAdapter 的建立方式，一般我們請求回來的資料都是直接解析成 model 陣列，如果在 viewController 中直接進行顯式的轉換無疑也是極不友好的，這就需要我們繼續做一層封裝了！

自此我們已經可以較好的解決前面提出的1、2兩點問題，針對問題 '3. 需要在 viewController 中響應 Cell 內部的點選事件'，筆者做法如下：

  1. 為 cell 新增一個 delegate 方法 'tableViewCell:event:';
  2. 在 cell 初始化的時候設定 viewController 為 delegate，並在 viewController 中實現相關的協議方法；
  3. 在 cell 的對應事件中執行類似 '[self.delegate tableViewCell:self event:@(STDEditEventInputFinish)]' 的操作告訴 viewController 發生了什麼；

根據這個思路進行封裝，我們已經可以較好的實現UITableView的解耦及呼叫簡化，接下去就是再做一些結構上的優化了！筆者根據這個思路封裝了一個庫 STDTableView 並附有相關的demo，支援CocoaPods安裝，歡迎大家下載檢視，有什麼問題的話歡迎一起討論或者提issue ！

相關文章