打造一个直观易复用的iOS设置菜单页

几乎每一个App都有一个设置菜单页,而且他们几乎都长这样:

反面教材

最简单最原始的做法是这样的:

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
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
  UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cell"
                                                          forIndexPath:indexPath];

  switch (indexPath.row) {
      case 0:
          // configure cell
          break;
      case 1:
          // configure cell
          break;
      case 2:
          // configure cell
          break;
  }
  return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
    [tableView deselectRowAtIndexPath:indexPath animated:YES];

    switch (indexPath.row) {
        case 0:
            // click cell 0
            break;
        case 1:
            // click cell 1
            break;
        case 2:
            // click cell 2
            break;
    }
}

这样做不仅违反了DRY原则,在菜单项比较多的情况下烦不胜烦,而且一旦需要修改某个菜单项的内容,或者插入或者删除,修改起来都是非常容易出错的,换句话说,可维护性非常差。

抽象、依赖转移

通过观察我们可以发现,这些列表的结构非常相似,那么很自然地我们可以想到建立一个通用的模型来表示一个菜单.

KOSettingItem.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@interface KOSettingItem : NSObject

@property (copy, nonatomic) NSString *title;
@property (strong, nonatomic) UIImage *imageIcon;
@property (assign, nonatomic) UITableViewCellAccessoryType accessoryType;
@property (copy, nonatomic) void(^handleCallback)();

+ (instancetype) itemWithTitle:(NSString *)title
                          icon:(UIImage *)image;

+ (instancetype) itemWithTitle:(NSString *)title
                          icon:(UIImage *)image
                         block:(void(^)())handle;

- (id)initWithTitle:(NSString *)title
               icon:(UIImage *)image
              block:(void(^)())handle;

  
@end   
KOSettingItem.m
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
 @implementation KOSettingItem

  + (instancetype) itemWithTitle:(NSString *)title
                            icon:(UIImage *)image{
      return [[self alloc] itemWithTitle:title icon:image];
  }
  
  + (instancetype) itemWithTitle:(NSString *)title
                            icon:(UIImage *)image
                            block:(void(^)())handle{
      KOSettingItem *item = [[self alloc] initWithTitle:title icon:image block:handle];
      return item;
  }
  
  - (id)initWithTitle:(NSString *)title
                 icon:(UIImage *)image
                block:(void(^)())handle{
      if (self = [super init]) {
          self.title = title;
          self.imageIcon = image;
          self.handleCallback = handle;
          self.accessoryType = UITableViewCellAccessoryDisclosureIndicator;
      }
      return self;
  }
  
  @end
  

一个简单的模型就这样建好了,其中我们用block写了一个handleCallback用来处理表格的点击事件,接着我们来应用到TableView中,首先新增一个property @property (strong, nonatomic) NSArray *settingItems;

然后在ViewDidLoad中

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
KOSettingItem *item1 = [KOSettingItem itemWithTitle:@"菜单1" icon:[UIImage imageNamed:@"Carrot"]];
[item1 setHandleCallback:^{
    NSLog(@"点击菜单1");
}];

KOSettingItem *item2 = [KOSettingItem itemWithTitle:@"菜单2" icon:[UIImage imageNamed:@"Owl"]];
[item1 setHandleCallback:^{
    NSLog(@"点击菜单2");
}];

KOSettingItem *item3 = [KOSettingItem itemWithTitle:@"菜单3" icon:[UIImage imageNamed:@"Rubber-Duck"]];
[item1 setHandleCallback:^{
    NSLog(@"点击菜单3");
}];

KOSettingItem *item4 = [KOSettingItem itemWithTitle:@"菜单4" icon:[UIImage imageNamed:@"Snowman"]];
[item1 setHandleCallback:^{
    NSLog(@"点击菜单4");
}];

self.settingItems = @[item1, item2, item3, item4];

最后修改一下TableView的Datasource和Delegate

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
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
    return self.settingItems.count;
}

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath{
    return 44;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cell"
                                                            forIndexPath:indexPath];

    KOSettingItem *item = self.settingItems[indexPath.row];
    cell.textLabel.text = item.title;
    cell.imageView.image = item.imageIcon;
    cell.accessoryType = item.accessoryType;

    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
    [tableView deselectRowAtIndexPath:indexPath animated:YES];

    KOSettingItem *item = self.settingItems[indexPath.row];
    if (item.handleCallback) {
        item.handleCallback();
    }
}

我们发现再也不需要冗长的switch语句,如果需要增删菜单项,只需要修改settingItems里面的item顺序,并且由于点击事件绑定到KOSettingItem里面,也不需要担心事件与item不对应的情况,除非有特殊的样式需求,我们可以几乎不用再更改UITableViewDataSource与UITableViewDelegate的实现。

尾声

文章只是提供了一个思路,而且出于简明的目的KOSettingItem的模型非常简单,实际上你可以通过添加变量达到更多的可定制化效果,比如分割线的offset,自定义的accessoryView等等,完整的demo可以戳这里

运行一下,最后的结果如图,虽然还是平淡无奇 :)

最后吐槽一下自己,真的好久没写博客了(:з」∠)

Comments