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

商城篩選側邊欄不必自己刻:ZYSideSlipFilter 完整拆解

編輯:iOS 開發基礎

本文為投稿文章,作者:Zhiyi

一句話說清楚它是什麼

ZYSideSlipFilter 是一個從側邊滑出的條件篩選器。它把「高度自訂的篩選分區」「AutoLayout 自動撐開 cell 高度」以及「選擇條件 → 保存選擇狀態 → 重置條件」這套標準互動全部打包好,即插即用。至於裡面的「內臟」要換成什麼、長什麼樣子,完全由你決定——Demo 做的是商城風格,實際怎麼用取決於你的業務。

而貫穿整個工作流程的核心,是資料源。

先看結構圖

從截圖不難發現一件事:畫面上的資料、篩選分區、UI 結構,沒有一項是 ZYSideSlipFilter 替你決定的,全部由開發者自訂。我們透過 dataList 這個資料源與 Filter 交流,內容包含每個篩選條目的 cell 結構、篩選條件、預設選中項,以及使用者操作後的結果。

換個比喻:這是一個「會被改寫」的資料源,像一份問卷——進去時乾淨空白,出來時已經被畫滿塗滿。那麼,我們該如何透過 Filter 這個中間人,引導使用者把問卷填完?接著看資料源的結構。

RegionModel 與 containerCellClass

圖看起來有點複雜,但其實只需要認識最左邊的 ZYSideSlipFilterRegionModel:一個 RegionModel 代表一個篩選分區。也就是說,想多加一個篩選區域,就 new 一個 RegionModel 放進資料源即可。

在 RegionModel 裡面,最基本的屬性是 containerCellClass,它指向「這個分區的 UI 佈局與邏輯程式碼所在的類」,也就是一個 UITableViewCell 子類。我們要求這個自訂類必須繼承自 SideSlipBaseTableViewCell。完成三步——寫出自訂 cell、建立 RegionModel、把 class 賦值給 containerCellClass 並放進 dataList——你的 Filter 就能跑起來了。

配置篩選項

前面那張圖已列出 Demo 的三塊篩選分區,下方箭頭對應各自的 RegionModel 內容。containerCellClass 配置好之後,還有幾個好用的欄位:

  • regionTitle:分區標題
  • itemList:自訂的選項 Model 陣列
  • isShowAll:是否展開全部選項
  • selectedItemList:使用者已選中的選項 Model

這裡要再強調一次:使用者互動之後,我們要修改的是 RegionModel 本身;使用者按下提交時,Filter 拿到的就是這些被改過的內容。

以上屬性若用不到、或不滿足需求都無妨,customDict 留給你塞任何附加資料。

協同工作的主要 API

搞懂如何建立自己的 Filter 之後,剩下的就是這幾個對接點:

自訂篩選分區 cell

  • 繼承自 SideSlipBaseTableViewCell
  • + (NSString *)cellReuseIdentifier; 回傳 cell 的重用標識
  • + (CGFloat)cellHeight; 回傳固定高度(cell 高度設定方式之一,後文詳解)
  • + (instancetype)createCellWithIndexPath:(NSIndexPath *)indexPath; 回傳 cell 實例
  • - (void)updateCellWithModel:(ZYSideSlipFilterRegionModel **)model indexPath:(NSIndexPath *)indexPath; cell 的更新入口,傳入 model 位址指標,供 cell 取得並寫回使用者互動結果
  • - (void)resetData; 使用者按下重置時呼叫

SideSlipBaseTableViewCell 的 delegate

delegate 即 ZYSideSlipFilterController 物件,提供三個回呼:

  • sideSlipTableViewCellNeedsReload:該 cell 需要刷新
  • sideSlipTableViewCellNeedsPushViewController:animated::該 cell 觸發條件後需要 push 頁面
  • sideSlipTableViewCellNeedsScrollToCell:atScrollPosition:animated::該 cell 觸發條件後需要滾動到列表中的指定位置

通知

  • FILTER_NOTIFICATION_NAME_DID_RESET_DATA
  • FILTER_NOTIFICATION_NAME_DID_COMMIT_DATA

設定檔 ZYSideSlipFilterConfig

  • FILTER_NAVIGATION_CONTROLLER_CLASS:Filter 使用的導航控制器類別(構造方法僅支援 - initWithRootViewController:)
  • 各項 UI 參數

本地化 Localizable.strings

目前配置了兩個底部按鈕的文字,可在自己專案的 .strings 檔中覆寫;不設定則預設為 Reset 與 Commit。

"sZYFilterReset" = "Reset";
"sZYFilterCommit" = "Commit";

關於 cell 高度自適應

ZYSideSlipFilter 每次 reloadData 時都會動態計算 cell 高度,但有一個前提:cell 內的 subviews 必須對 tableView 的 ContentView 佈好水平與垂直方向的約束。請注意——一定要加在 ContentView 上,加在 tableView 上是無效的。

若你希望使用固定高度,只要覆寫父類的 + cellHeight 方法即可。

使用方式

建立 ZYSideSlipFilterController 實例,並由「呼出者」controller 持有它。這樣做的好處是能保留 Filter 的狀態,並且可以重複呼出(呼出者必須具備 navigationController)。

self.filterController = [[ZYSideSlipFilterController alloc] initWithSponsor:self
    resetBlock:^(NSArray *dataList) {
        // Reset Data
    }
    commitBlock:^(NSArray *dataList) {
        // Commit Data
    }];

_filterController.animationDuration = .3f;
_filterController.sideSlipLeading = 0.15 * [UIScreen mainScreen].bounds.size.width;
_filterController.dataList = [self packageDataList];
// 需要導航列時:
[_filterController.navigationController setNavigationBarHidden:NO];
[_filterController setTitle:@"title"];

這樣就能投遞使用了嗎?還不夠——最關鍵的永遠是資料源 dataList。Filter 會依照資料源的結構規則運作,資料源準備好之後,一行就能讓它出場:

[_filterController show];

自訂篩選 RegionCell

@interface Custom***TableViewCell : SideSlipBaseTableViewCell

+ (NSString *)cellReuseIdentifier {
    // cellReuseIdentifier
}

+ (CGFloat)cellHeight {
    // option:也可以改用 autolayout 約束 cellContentView,而不實作此方法
}

+ (instancetype)createCellWithIndexPath:(NSIndexPath *)indexPath {
    // cell instance object
}

- (void)updateCellWithModel:(ZYSideSlipFilterRegionModel **)model
                  indexPath:(NSIndexPath *)indexPath {
    // update your cell
}

- (void)resetData {
    // option:使用者點擊 resetButton 時的回應
}

更細節的用法請直接參考 Demo。

Demo 專案地址:https://github.com/liuzhiyi1992/ZYSideSlipFilter

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