项目地址：ChainDroplist

最近项目中经常遇到 下拉/上拉列表(droplist) 的需求，共性比较多，但是会有细微的差异；首选当然是用UITableView，但是如果每个droplist都创建个datasource，delegate未免也太麻烦了；索性抽出点时间封装了一个简单的链式Droplist，主要满足以下几种需求：

• 使用 chain-style program（在一个方法里完成 droplist cell组装、展示、选择 的处理）
• 提供可选的 droplist hostview（并不是所有 dropilst 都直接简单粗暴的加载在 KeyWindow 上）
• 提供 可选的 tap rotation icon（点击、展示droplist应该伴随着icon的旋转，不是么？）
• 提供可选的 droplist baseView（droplist应该在点击view的下沿或者上沿进行伸展）
• 上方/下发 展示空间不足会主动调整展开方向（相信我，虽然用户不在意，但是总会我测试会提这个bug的）
• 默认展示5行，如果展示空间不足，自动**-1**直至可以满足展示条件(小屏用户的体验还是要考虑的)
• Cell支持可最大化扩展，目前建议使用继承方式（你永远不知道下一个设计师能设计出来什么）

先来看个简单的Sample：

再来看下使用方法，有个直观的印象：

- (void)showDroplist:(UIView *)baseView icon:(UIView *)icon hostView:(UIView *)hostView
{[[[[[ChainedDroplistView alloc] initWithConfig:^(ChainedDroplistView *droplist) {droplist.hostView = self.view; /* 展示droplist的父view，默认为Window */droplist.baseView = baseView; /* 用于确定 droplist 的 top/bottom */droplist.rotationView = icon; /* 展示droplist的同时做旋转的view */droplist.cellHeight = 60; /* 默认Cell height */droplist.datas = [self createTestDatas]; /* 创建 cell datas */}] registCustomerCellsWithConfig:^(UITableView *tableView) {/* 绑定 Cell Identifier */ [tableView registerClass:ChainedDroplistBaseCell.class forCellReuseIdentifier:kChainedDroplistBaseCellIdentifier];}] show] /* 调用 show 之后会执行展示动画 */processAfterSelected:^(NSInteger index) {/* 用户选中某个 Cell 后会执行该 block */NSLog(@"U have selected index -> [%@]", @(index));}];}复制代码

代码结构

基于UITableView封装，通过 ChainedDroplistModelProtocol 和 ChainedDroplistCellProtocol 来衔接 Cell 和 Model

ChainedDroplistModelProtocol

• 提供 registerClass:forCellReuseIdentifier: 的 identifier
• 可以直接继承 ChainedDroplistBaseModel，重写 - (NSString *)strCellIdentifier 方法提供自定义 identifier

Cell

• configCellWithModel: 在每个 tableView: cellForRowAtIndexPath: 方法中都会调用，该方法中可以根据model更新Cell

关键代码：

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{NSInteger index = indexPath.row;NSAssert(index < self.cellDatas.count, @"index[%@] beyonds the max count[%@] of datas", @(index), @(self.cellDatas.count));// 根据 ChainedDroplistModelProtocol strCellIdentifier 获取指定Cellid<ChainedDroplistModelProtocol> model = self.cellDatas[index];UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:model.strCellIdentifier];NSAssert([cell conformsToProtocol:@protocol(ChainedDroplistCellProtocol)],@"cell[%@] from identifier[%@] must conforms protocol [%@]",cell, model.strCellIdentifier, NSStringFromProtocol(@protocol(ChainedDroplistCellProtocol)));UITableViewCell <ChainedDroplistCellProtocol> * droplistCell = (UITableViewCell <ChainedDroplistCellProtocol> *)cell;if ([droplistCell respondsToSelector:@selector(configCellWithModel:)]) {// 刷新Cell[droplistCell configCellWithModel:model];}return droplistCell;
}
复制代码

• ChainedDroplistBaseCell中initWithStyle: reuseIdentifier:调用了 setupUI、setupConstraints用于设置UI和约束， 可以直接继承 ChainedDroplistBaseCell，重写 setupUI setupConstraints 完成 Customer cell 的定义

- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier
{self = [super initWithStyle:style reuseIdentifier:reuseIdentifier];if (self) {self.selectionStyle = UITableViewCellSelectionStyleNone;[self setupUI];[self setupConstraints];}return self;
}
复制代码

identifier 的声明和定义

• 在Model中利用 FOUNDATION_EXPORT NSString *const identifier 声明identifier
• 在Cell中定义相关 identifier: NSString *const identifier=@"identifier"

这么做只是为了通过简单的 identifier 搜索就可以找出 cell 和对应的 model

Sample

想了解的同学可以参考示例中的使用方法

1. cd Example/
2. run pod install
3. open ChainedDroplist.xcworkspace/

为了尽可能说明ChainDroplist的设计初衷，示例中列举了比较详细的使用场景，包括：

1. 默认场景：向下展开，默认5行可见
2. 向下展示空间不足：根据 hostView、baseView、cellHeght 来计算可视空间，如果下方空间不足会改为向上展示
3. rotationView用于在展开droplist时做同步旋转
4. 如果 上方、下方 空间均不足以展示5行，主动计算最少可展示行数并展示
5. 通过继承 ChainedDroplistBaseCell、ChainedDroplistBaseModel 来实现自定义样式（虽然我不喜欢使用继承的方式，但是对于轻量的扩展场景是最适合不过的了）