WAMSimpleDataSource,更优雅的编写静态UITableView

2016-12-22

嘛,开始之前先双手奉上Github项目地址,欢迎各位大佬star:
https://github.com/WAMaker/WAMSimpleDataSource

相信做iOS开发的小伙伴们经常会遇到这样的页面:


对于这样的静态列表我们可以直接用 storyboard 拖一个出来,或者直接用代码创建。我个人的话会选择用代码直接创建,但是之前一直有的问题是没有较好的数据源表示方式,需要对 indexPath 进行硬编码,这导致了在 tableView 的代理里面需要进行判断:

1
2
3
4
5
6
7
8
9
if (indexPath.section == 0) {
if (indexPath.row == 0) { // email
// do something
} else if (indexPath.row == 1) { // phone
// do something
}
} else if (indexPath.section == 1) {
// do something
}

稍微好点的会在相关的判断边上做注释,但是这样写依然容易在往后(产品)调整顺序时调整了一个地方而忘记另外的,总的来说就是代码不够优雅。基于这样的背景,在尝试了各种方式之后,产生了一个可行的解决方案 —— WAMSimpleDataSource。

设计思路

在定义 WAMCellInfoWAMSectionInfo 两个类时我选择引入别名( alias )来解决 indexPath 的硬编码问题(可能有人会说alias也是硬编码,但这样做提升了代码的可读性=0=)。

WAMCellInfo

WAMCellInfo 为 cell 的创建提供了最基本的信息,如 reuseIdentifier ,title,detail。用户也能传入自定义的 cell 而不必担心循环引用的问题。

WAMSectionInfo

WAMSectionInfo 作为 WAMCellInfo 的容器,提供了添加删除替换,以及基于 alias 对 WAMCellInfoWAMCellInfo索引方法。

WAMDataSource

WAMDataSource 是所有 WAMSectionInfo 的容器,同样提供了添加删除替换,以及基于 alias 对 WAMSectionInfo索引方法。

Demo

让我们就以一个简单的 demo 看下 WAMSimpleDataSource 在静态列表中如何能让代码看起来更简洁。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
static NSString *const kReuseIdentifier = @"tableViewCellIdentifier";
static NSString *const kIdentifierCellAlias = @"kIdentifierCellAlias";
static NSString *const kSelfDefineCellAlias = @"kSelfDefineCellAlias";
static NSString *const kSectionZeroAlias = @"kSectionZeroAlias";
static NSString *const kSectionOneAlias = @"kSectionOneAlias";
#pragma mark - Initialization
// section info初始化
WAMSectionInfo *zero = [WAMSectionInfo infoWithCellInfos:@[] alias:kSectionZeroAlias];
// 添加操作,cell info初始化
[zero appendingCellInfo:[WAMCellInfo infoWithSelfDefineCell:self.customizedCell alias:kSelfDefineCellAlias]];
WAMSectionInfo *one = [WAMSectionInfo infoWithCellInfos:@[
[WAMCellInfo infoWithReuseIdentifier:kReuseIdentifier title:nil detail:nil alias:kIdentifierCellAlias]
] alias:@"oneSectionAlias"];
// data source初始化
self.dataSource = [WAMDataSource dataSourceWithSectionInfos:@[zero, one]];
#pragma mark - UITableViewDataSource
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return self.dataSource.sectionInfos.count;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.dataSource.sectionInfos[section].cellInfos.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
WAMCellInfo *cellInfo = self.dataSource.sectionInfos[indexPath.section].cellInfos[indexPath.row];
__kindof UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellInfo.identifier forIndexPath:indexPath];
// 根据不同的alias进行不同的操作
if ([cellInfo.alias isEqualToString:kSelfDefineCellAlias]) {
// do something
} else if ([[cellInfo.alias isEqualToString:kIdentifierCellAlias]) {
// do something
}
.
.
.
return cell;
}
- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
return self.dataSource.sectionInfos[section].sectionHeaderHeight;
}
- (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section {
return self.dataSource.sectionInfos[section].sectionFooterHeight;
}

总结与缺陷

现在的 WAMDataSource 还没办法做到直接作为 tableView 的数据源,这是在今后的更新中会解决的问题。虽然 WAMSimpleDataSource 并没有减少很多代码量,但能提升静态列表中代码的可读性以及可维护性,个人觉得还是值得的。

希望各位会喜欢,有问题可以留言或者在 Github 上给我提 PR,非常感谢。

GitHub repo:https://github.com/WAMaker/WAMSimpleDataSource