UITableView

在一个纵列中用一行行去显示数据的视图 A View that presents data using rows arranged in a single column

Overview

UITableView 在一个纵列中显示一个列表。UITableView是UIScrollView的子类，允许用户滑动列表，但是仅允许纵向滑动。列表中包含（comprise）单条记录的视图是UITableViewCell对象。Cell有标题，图片等内容；靠近右边也可以有附件视图（accessory view）。附件视图是披露（disclosure）下一层详细信息的指示器或者按钮。附件视图可以是系统提供的视图也可以是自定义视图。UITableView可以进入编辑模式,这样就可以插入，删除和重新排序列表中的行。

UITableViewCell

UITableViewCell

---

UITableViewCell Hierarchy

UITableViewCell Hierarchy

如图2 UITableViewCell Hierarchy，一个UITableView 可以有 backgroundView（即其中的UIView，backgrondView默认为空，只有设置了backgroundView属性才会有），contentView（即contentView属性，可以添加自定义视图 ），accessory view（即其中的UIButton），separatorView（分割线默认显示，可以修改UITableView的separatorStyle隐藏分割线）

---

UITableView由0个或多个章节（section）组成，每个章节由一行行组成。章节由它在UITableView中的索引号标示，行由它在章节中的索引号标示。每个章节可以有头部和尾部视图。

---

UITableView有两种风格，UITableViewStylePlain和UITableViewStyleGrouped。当创建一个UITableView时，必须指定一种风格，而且不能够更改。在UITableViewStylePlain中，当一个section的rows有一部分可见时，section的header和footer浮动在内容顶部。plain style的tableView可以有一个section索引，作为一个bar在table的右边(例如A ~ Z)。你可以点击一个特定的标签，跳转到目标section。在 UITableViewStyleGrouped，所有单元格拥有一个默认的背景颜色和默认背景视图。背景视图为特定section中的所有cell提供可视分组。例如，一个group可以是一个人的名字和标题，另一个group可以是电话,电子邮件帐户等。

UITableViewStylePlain

UITableViewStylePlain

UITableViewStyleGrouped

UITableViewStyleGrouped

事实上，两种style都可以有右边的索引栏。实现索引栏的效果，需要实现以下的方法：

@protocol UITableViewDataSource

- (nullable NSArray<NSString *> *)sectionIndexTitlesForTableView:(UITableView *)tableView;                               
// return list of section titles to display in section index view (e.g. "ABCD...Z#")

- (NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index;  
// tell table which section corresponds to section title/index (e.g. "B",1))

@end

/**
 * 
 * example
 **/
 
 - (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView 
{
    return @[@"1",@"2",@"3",@"4",@"5",@"6"];
}

- (NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index;
{
    return index;
}
 

---

UITableView 必须有一个数据源对象和一个委托对象。数据源对象必须实现UITableViewDataSource协议，委托对象必须实现UITableViewDelegate协议。数据源对象提供信息，用于构建列表，并管理当插入，删除，重新排序操作时的数据模型。委托对象管理列表每一行的配置，选择，重排，高亮，附件视图和编辑操作。

---

当UITableView收到setEditing:animated:消息时，进入编辑模式。在这个模式下，每一个可见的行都会显示编辑和重排的视图。当点击这些视图时，数据源对象会收到tableView:commitEditingStyle:forRowAtIndexPath:消息，这样就可以修改数据模型，然后调用deleteRowsAtIndexPaths:withRowAnimation: 或者 insertRowsAtIndexPaths:withRowAnimation:提交修改。 在编辑模式中，当UITableView的showReorderControl属性设置为YES，且数据源对象实现了tableView:canMoveRowAtIndexPath:方法，移动cell时，数据源对象就会收到tableView:moveRowAtIndexPath:toIndexPath:消息，这样就可以重排消息模型。

edit mode

edit mode

// After a row has the minus or plus button invoked (based on the UITableViewCellEditingStyle for the cell), the dataSource must commit the change
// Not called for edit actions using UITableViewRowAction - the action's handler will be invoked instead
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath;

// Data manipulation - reorder / moving support

- (void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath;

/**
 *
 * example
 **/

- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath
{
    if( UITableViewCellEditingStyleDelete == editingStyle)
    {
        [self.array[indexPath.section] removeObjectAtIndex:indexPath.row];
        [tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationFade];
    }
}


- (void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath
{
    NSString * str = self.array[sourceIndexPath.section][sourceIndexPath.row];
    [self.array[sourceIndexPath.section] removeObjectAtIndex:sourceIndexPath.row];

    [self.array[destinationIndexPath.section] insertObject:str atIndex:destinationIndexPath.row];

}

// 必须进入编辑模式，这些方法才有效。在这些方法中，必须实现对数据源的修改，否则会出现闪退


/**
 *
 * UITableView 自己也提供了这些方法，由于修改tableView中的行。
 * 调用这些方法前，必须对相应的数据源做修改，否则会闪退
 **/
- (void)insertSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation;
- (void)deleteSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation;
- (void)reloadSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation NS_AVAILABLE_IOS(3_0);
- (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection NS_AVAILABLE_IOS(5_0);

- (void)insertRowsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation;
- (void)deleteRowsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation;
- (void)reloadRowsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation NS_AVAILABLE_IOS(3_0);
- (void)moveRowAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath NS_AVAILABLE_IOS(5_0);

---

UITableView缓存了可见行的cell，你可以创建自定义的UITableViewCell。UITableView重写了layoutSubviews方法，这样仅当创建一个新的UITableView对象或者分配了一个新的数据源对象，都会自动调用reloadData方法。reloadData会清除当前的状态，包括当前选择的行。但是随后的layoutSubviews不会触发reload

参考文档

iOS UITableView 的 Plain和Grouped样式的区别