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


從截圖不難發現一件事:畫面上的資料、篩選分區、UI 結構,沒有一項是 ZYSideSlipFilter 替你決定的,全部由開發者自訂。我們透過 dataList 這個資料源與 Filter 交流,內容包含每個篩選條目的 cell 結構、篩選條件、預設選中項,以及使用者操作後的結果。
換個比喻:這是一個「會被改寫」的資料源,像一份問卷——進去時乾淨空白,出來時已經被畫滿塗滿。那麼,我們該如何透過 Filter 這個中間人,引導使用者把問卷填完?接著看資料源的結構。

圖看起來有點複雜,但其實只需要認識最左邊的 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 留給你塞任何附加資料。
搞懂如何建立自己的 Filter 之後,剩下的就是這幾個對接點:

SideSlipBaseTableViewCell+ (NSString *)cellReuseIdentifier; 回傳 cell 的重用標識+ (CGFloat)cellHeight; 回傳固定高度(cell 高度設定方式之一,後文詳解)+ (instancetype)createCellWithIndexPath:(NSIndexPath *)indexPath; 回傳 cell 實例- (void)updateCellWithModel:(ZYSideSlipFilterRegionModel **)model indexPath:(NSIndexPath *)indexPath; cell 的更新入口,傳入 model 位址指標,供 cell 取得並寫回使用者互動結果- (void)resetData; 使用者按下重置時呼叫delegate 即 ZYSideSlipFilterController 物件,提供三個回呼:
sideSlipTableViewCellNeedsReload:該 cell 需要刷新sideSlipTableViewCellNeedsPushViewController:animated::該 cell 觸發條件後需要 push 頁面sideSlipTableViewCellNeedsScrollToCell:atScrollPosition:animated::該 cell 觸發條件後需要滾動到列表中的指定位置FILTER_NOTIFICATION_NAME_DID_RESET_DATAFILTER_NOTIFICATION_NAME_DID_COMMIT_DATAFILTER_NAVIGATION_CONTROLLER_CLASS:Filter 使用的導航控制器類別(構造方法僅支援 - initWithRootViewController:)目前配置了兩個底部按鈕的文字,可在自己專案的 .strings 檔中覆寫;不設定則預設為 Reset 與 Commit。
"sZYFilterReset" = "Reset"; "sZYFilterCommit" = "Commit";
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];
@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