iOS中UITableView使用总结

第一：UITableView的基本使用

一、初始化方法

- (instancetype)initWithFrame:(CGRect)frame style:(UITableViewStyle)style;  
 
//这个方法初始化表视图的frame大小并且设置一个风格，UITableViewStyle是一个枚举，如下： 
typedef NS_ENUM(NSInteger, UITableViewStyle) {
    UITableViewStylePlain,                  // 标准的表视图风格
    UITableViewStyleGrouped                 // 分组的表视图风格
};

二、常用属性

• 设置UITableView代理和数据源代理(注意：这一点至关重要)

@property (nonatomic, assign)   id  dataSource; 
@property (nonatomic, assign)   id    delegate; 

• 设置UITableViewCell高度(默认为44)(注意：当所有的Cell的高度相同可以有该属性设置Cell高度；当Cell的高度不同是就不可以用该属性设置了。)

@property (nonatomic)CGFloat rowHeight;  

• 设置分区的头视图高度和尾视图高度(当代理方法没有实现时才有效)

@property (nonatomic)          CGFloat                     sectionHeaderHeight;    
@property (nonatomic)          CGFloat                     sectionFooterHeight;  

注意：这个属性官方的解释是如果你的UITableViewCell高度是可变的，那么设计一个估计高度可以加快代码的运行效率。

@property (nonatomic)          CGFloat                     estimatedRowHeight;

• 下面这两个属性和上面相似，分别设置分区头视图和尾视图的估计高度

@property (nonatomic)          CGFloat            estimatedSectionHeaderHeight;  @property (nonatomic)          CGFloat            estimatedSectionFooterHeight; 

• 设置分割线的位置 和分割线颜色

@property (nonatomic)          UIEdgeInsets                separatorInset;
 @property (nonatomic, strong, nullable) UIColor *separatorColor 

三、常用方法详解

• 重载tableView

- (void)reloadData; 

• 重载索引栏

- (void)reloadSectionIndexTitles; 
// 这个方法常用语新加或者删除了索引类别而无需刷新整个表视图的情况下。 

• 返回区数 (注意：如果不写，默认是返回一个区)

- (NSInteger)numberOfSections; 

• 根据区返回行数

- (NSInteger)numberOfRowsInSection:(NSInteger)section; 

• 获取分区的大小(包括头视图，所有行和尾视图)

- (CGRect)rectForSection:(NSInteger)section;  

• 根据分区分别获取头视图，尾视图和行的高度

- (CGRect)rectForHeaderInSection:(NSInteger)section; 
- (CGRect)rectForFooterInSection:(NSInteger)section; 
- (CGRect)rectForRowAtIndexPath:(NSIndexPath *)indexPath; 

• 获取某个点在tableView中的位置信息 和获取某个cell在tableView中的位置信息

- (NSIndexPath *)indexPathForRowAtPoint:(CGPoint)point;   
- (NSIndexPath *)indexPathForCell:(UITableViewCell *)cell;  

• 根据一个矩形范围返回一个信息数组，数组中是每一行row的位置信息

- (NSArray *)indexPathsForRowsInRect:(CGRect)rect;  

• 通过位置路径获取cell

- (UITableViewCell *)cellForRowAtIndexPath:(NSIndexPath *)indexPath;  

• 根据分区获取头视图 和根据分区获取尾视图

- (UITableViewHeaderFooterView *)headerViewForSection:(NSInteger)section; 

- (UITableViewHeaderFooterView *)footerViewForSection:(NSInteger)section;  

• 使表示图定位到某一位置(行)

- (void)scrollToRowAtIndexPath:(NSIndexPath *)indexPath atScrollPosition:(UITableViewScrollPosition)scrollPosition animated:(BOOL)animated; 
// 注意：indexPah参数是定位的位置，决定于分区和行号。animated参数决定是否有动画。scrollPosition参数决定定位的相对位置，它使一个枚举，如下： 
typedef NS_ENUM(NSInteger, UITableViewScrollPosition) {
    UITableViewScrollPositionNone,//同UITableViewScrollPositionTop
    UITableViewScrollPositionTop,//定位完成后，将定位的行显示在tableView的顶部    
    UITableViewScrollPositionMiddle,//定位完成后，将定位的行显示在tableView的中间   
    UITableViewScrollPositionBottom//定位完成后，将定位的行显示在tableView最下面
};

• 使表示图定位到选中行

- (void)scrollToNearestSelectedRowAtScrollPosition:(UITableViewScrollPosition)scrollPosition animated:(BOOL)animated; 
这个函数与上面的非常相似，只是它是将表示图定位到选中的行。 

四、tableView操作刷新块的应用

在介绍动画块之前，我们先看几个函数：

• 给UITableView插入分区

- (void)insertSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation; 
animation参数是一个枚举，枚举的动画类型如下 
typedef NS_ENUM(NSInteger, UITableViewRowAnimation) {
    UITableViewRowAnimationFade,//淡入淡出
    UITableViewRowAnimationRight,//从右滑入
    UITableViewRowAnimationLeft,//从左滑入
    UITableViewRowAnimationTop,//从上滑入
    UITableViewRowAnimationBottom,//从下滑入
    UITableViewRowAnimationNone,  //没有动画
    UITableViewRowAnimationMiddle,          
    UITableViewRowAnimationAutomatic = 100  // 自动选择合适的动画
};

• 删除分区

- (void)deleteSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation; 

• 重载一个分区

- (void)reloadSections:(NSIndexSet *)sections withRowAnimation:(UITableViewRowAnimation)animation ; 

• 移动一个分区

- (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection; 

• 插入一些行

- (void)insertRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation; 

• 删除一些行

- (void)deleteRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation; 

• 重载一些行

- (void)reloadRowsAtIndexPaths:(NSArray *)indexPaths withRowAnimation:(UITableViewRowAnimation)animation; 

• 移动某行

- (void)moveRowAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath; 

了解了上面几个函数，我们来看什么是操作刷新块：
当我们调用的上面的函数时，tableView会立刻调用代理方法进行刷新，如果其中我们所做的操作是删除某行，而然数据源数组我们可能并没有刷新，程序就会崩溃掉，原因是代理返回的信息和我们删除后不符。
IOS为我们提供了下面两个函数解决这个问题：

• 开始块标志 、结束快标志

- (void)beginUpdates;  
- (void)endUpdates;  

我们可以将我们要做的操作全部写在这个块中，那么，只有当程序执行到结束快标志后，才会调用代理刷新方法。代码示例如下：

    [tab beginUpdates];
    [tab deleteRowsAtIndexPaths:@[[NSIndexPath indexPathForRow:1 inSection:0]] withRowAnimation:UITableViewRowAnimationLeft];
    [dataArray removeObjectAtIndex:1];
    [tab endUpdates];
//注意：不要在这个块中调用reloadData这个方法，它会使动画失效。 

五、UITableView的编辑操作

• 设置是否是编辑状态(编辑状态下的cell左边会出现一个减号，点击右边会划出删除按钮)

@property (nonatomic, getter=isEditing) BOOL editing;                              
- (void)setEditing:(BOOL)editing animated:(BOOL)animated; 

• 设置cell编辑模式下选择的状态

//设置cell是否可以被选中(默认为YES) 
@property (nonatomic) BOOL allowsSelection; 

//设置cell编辑模式下是否可以被选中
@property (nonatomic) BOOL allowsSelectionDuringEditing;   

//设置是否支持多选 
@property (nonatomic) BOOL allowsMultipleSelection; 

//设置编辑模式下是否支持多选 
@property (nonatomic) BOOL allowsMultipleSelectionDuringEditing; 

六、选中cell的相关操作

• 获取选中cell的位置信息

- (NSIndexPath *)indexPathForSelectedRow;  
获取多选cell的位置信息 
- (NSArray *)indexPathsForSelectedRows; 

• 代码手动选中与取消选中某行

- (void)selectRowAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated scrollPosition:(UITableViewScrollPosition)scrollPosition; 
- (void)deselectRowAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated; 
注意：这两个方法将不会回调代理中的方法。

七、tableView附件的相关方法

• 设置索引栏

//设置索引栏最小显示行数
@property (nonatomic) NSInteger sectionIndexMinimumDisplayRowCount;                  //设置索引栏字体颜色 
@property (nonatomic, retain) UIColor *sectionIndexColor; 
//设置索引栏背景颜色 
@property (nonatomic, retain) UIColor *sectionIndexBackgroundColor; 
//设置索引栏被选中时的颜色 
@property (nonatomic, retain) UIColor *sectionIndexTrackingBackgroundColor; 

• 设置分割线的风格

@property (nonatomic) UITableViewCellSeparatorStyle separatorStyle; 
这个风格是一个枚举，如下： 
typedef NS_ENUM(NSInteger, UITableViewCellSeparatorStyle) {
    UITableViewCellSeparatorStyleNone,//无线
    UITableViewCellSeparatorStyleSingleLine,//有线
    UITableViewCellSeparatorStyleSingleLineEtched  
};

• 设置tableView头视图 、设置tableView尾视图

@property (nonatomic, retain) UIView *tableHeaderView;   
@property (nonatomic, retain) UIView *tableFooterView;  

---

第二：UITbleViewCell滑动多按钮

#pragma mark 编辑按钮
- (void)setEditing:(BOOL)editing animated:(BOOL)animated
{
    [super setEditing:editing animated:animated];
    [self.myTableView setEditing:!self.myTableView.isEditing animated:YES];
}

#pragma mark 设置可以进行编辑
- (BOOL)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath
{
    return YES;
}

#pragma mark 设置编辑的样式
- (UITableViewCellEditingStyle)tableView:(UITableView *)tableView editingStyleForRowAtIndexPath:(NSIndexPath *)indexPath
{
  return UITableViewCellEditingStyleDelete;
}

#pragma mark 设置处理编辑情况
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath
{
    //根据不同的编辑状态做一些操作
}

#pragma mark 在滑动手势删除某一行的时候，显示出更多的按钮
- (NSArray *)tableView:(UITableView *)tableView editActionsForRowAtIndexPath:(NSIndexPath *)indexPath
{
    //添加一个删除按钮
    UITableViewRowAction *deleteRowAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleDestructive title:@"删除" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
        NSLog(@"点击了删除");

        //移除要删除的数据
        [self.datas removeObjectAtIndex:indexPath.row];
        //更新UITableView
        [tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
    }];

    // 添加一个置顶按钮
    UITableViewRowAction *topRowAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleDefault title:@"置顶" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
        NSLog(@"点击了置顶");
        //交换数据
        [self.datas exchangeObjectAtIndex:indexPath.row withObjectAtIndex:0];
     
        NSIndexPath *firstIndexPath = [NSIndexPath indexPathForRow:0 inSection:indexPath.section];
        //更新UITableView
        [tableView moveRowAtIndexPath:indexPath toIndexPath:firstIndexPath];
    }];
    topRowAction.backgroundColor = [UIColor blueColor];

    // 添加一个更多按钮
    UITableViewRowAction *moreRowAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleNormal title:@"更多" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
        NSLog(@"点击了更多");

        [tableView reloadRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationMiddle];
    }];
    moreRowAction.backgroundEffect = [UIBlurEffect effectWithStyle:UIBlurEffectStyleDark];
    // 将设置好的按钮放到数组中返回
    return @[deleteRowAction, topRowAction, moreRowAction];

}