# 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](https://2405125319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjGnDTBdNpUqMiGQbVG%2Fuploads%2Fgit-blob-69c36bf988028104d3ff2cbc4c23b120d5cbf639%2FUITableViewCell.png?alt=media) *** **UITableViewCell Hierarchy** ![UITableViewCell Hierarchy](https://2405125319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjGnDTBdNpUqMiGQbVG%2Fuploads%2Fgit-blob-cc7f3858b9bd66f726d026992a716d767888b4b6%2FUITableViewCell_Hierarchy.png?alt=media) > 如**图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](https://2405125319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjGnDTBdNpUqMiGQbVG%2Fuploads%2Fgit-blob-441f9945d8c4f1df1b8e144c58ccec9e9e63e0d7%2FUITableViewStylePlain.png?alt=media) **UITableViewStyleGrouped** ![UITableViewStyleGrouped](https://2405125319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjGnDTBdNpUqMiGQbVG%2Fuploads%2Fgit-blob-1604ab8f30f4fb1121db0fe1f46878ceacdefa0f%2FUITableViewStyleGrouped.png?alt=media) 事实上，两种style都可以有右边的索引栏。实现索引栏的效果，需要实现以下的方法： ``` @protocol UITableViewDataSource - (nullable NSArray *)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](https://2405125319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjGnDTBdNpUqMiGQbVG%2Fuploads%2Fgit-blob-34b1287d60a10aced9469898bd997056ce3a4c5f%2Fedit_mode.png?alt=media) ``` // 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 *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation; - (void)deleteRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation; - (void)reloadRowsAtIndexPaths:(NSArray *)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样式的区别](https://www.jianshu.com/p/764ed5aa46cf)