Links

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

参考文档