做專案時常常會用到「下拉式選單」這種互動元件。由於先前已經實作過一次,這次索性花點時間回頭把它整理、打磨成一個可重複使用的元件,並補上幾項基礎功能,方便日後在別的專案裡直接複用,也能提供給有需要的朋友參考。
和 UITableView 類似,這個下拉選單同樣採用「資料來源(DataSource)+ 代理(Delegate)」的設計模式,把資料的提供與事件的回饋交給外部處理,讓元件本身保持通用。以下為它的介面定義:
1 // 2 // XWDropdownMenu.h 3 // XWReusableCodeLib 4 // 5 // Created by xiao on 15/10/30. 6 // Copyright © 2015年 xiao. All rights reserved. 7 // 下拉菜單 8 9 #import <UIKit/UIKit.h> 10 11 @class XWDropdownMenu; 12 #pragma mark 數據源方法 13 @protocol XWDropdownMenuDataSource <NSObject> 14 @required 15 /** 16 * 主表格一共有多少行 17 */ 18 - (NSInteger)numberOfRowsInMainTable:(XWDropdownMenu *)dropdownMenu; 19 /** 20 * 主表格每一行的標題 21 * @param row 行號 22 */ 23 - (NSString *)dropdownMenu:(XWDropdownMenu *)dropdownMenu titleForRowInMainTable:(NSInteger)row; 24 /** 25 * 主表格每一行的子數據 數組 26 * @param row 行號 27 */ 28 - (NSArray *)dropdownMenu:(XWDropdownMenu *)dropdownMenu subdataForRowInMainTable:(NSInteger)row; 29 @optional 30 /** 31 * 主表格每一行 分類數量 32 * @param row 行號 33 */ 34 - (NSString *)dropdownMenu:(XWDropdownMenu *)dropdownMenu countForRowInMainTable:(NSInteger)row; 35 /** 36 * 子表格每一行子數據 分類數量 37 * @param row 行號 38 */ 39 - (NSArray *)dropdownMenu:(XWDropdownMenu *)dropdownMenu subdataCountForRowInSubTable:(NSInteger)row; 40 /** 41 * 主表格每一行的圖標 42 * @param row 行號 43 */ 44 - (NSString *)dropdownMenu:(XWDropdownMenu *)dropdownMenu iconForRowInMainTable:(NSInteger)row; 45 /** 46 * 子表格每一行的選中圖標 47 * @param row 行號 48 */ 49 - (NSString *)dropdownMenu:(XWDropdownMenu *)dropdownMenu selectedIconForRowInMainTable:(NSInteger)row; 50 @end 51 52 #pragma mark 代理方法 53 @protocol XWDropdownMenuDelegate <NSObject> 54 55 @optional 56 - (void)dropdownMenu:(XWDropdownMenu *)dropdownMenu didSelectRowInMainTable:(NSInteger)row; 57 - (void)dropdownMenu:(XWDropdownMenu *)dropdownMenu didSelectRowInSubTable:(NSInteger)subrow inMainTable:(NSInteger)mainRow; 58 59 @end 60 61 #pragma mark 構造方法 62 @interface XWDropdownMenu : UIView 63 + (instancetype)dropdownMenu; 64 -(void)refreshMenu; 65 66 @property (nonatomic, weak) id<XWDropdownMenuDataSource> dataSource; 67 @property (nonatomic, weak) id<XWDropdownMenuDelegate> delegate; 68 69 /**主表被選中的字體顏色,默認是黑色*/ 70 @property (strong, nonatomic) UIColor *selectedRowTextColor; 71 /**該屬性設置成YES,主表比較小*/ 72 @property (nonatomic, assign)BOOL isMainTableSmall; 73 @end
從介面設計可以看出,這個下拉選單支援主表與子表的兩層結構:資料來源必須提供主表的行數、標題與各行的子資料;而圖示、分類數量、選中樣式等則列為可選方法,讓使用者在需要時才實作。代理部分則負責回饋「主表被點選」與「子表被點選」這兩種互動事件。
由於牽涉的程式碼量不少,無法在此完整貼出,因此僅列出各個方法並附上註解。以下附上簡單的 demo 與效果圖,方便你快速理解它的運作方式:
