注册 登录  
 加关注
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

云水禅心

淡若秋菊何妨瘦, 清到梅花不畏寒.

 
 
 

日志

 
 

UITableView编辑模式  

2012-11-30 19:55:27|  分类: iphone |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |

http://www.winddisk.com/2012/07/05/uitableview_edit_mod/

UITableView除了常规的选择模式(selection mode)外还有一个编辑模式(editing mode),在编辑模式中可实现删除,插入,多选,重排序等。

一.进入编辑模式

  • 通过直接设置UITableView的editing属性或向其发送setEditing:animated:消息,可将其置于编辑模式。
     self.tableview.editing = YES; [self.tableview setEditing:YES animated:YES]; 
  • UIViewController本身也有editing属性和setEditing:animated:方法,在当前视图控制器由导航控制器控制且导航栏中包含editButtonItem时,若UIViewController的editing为NO,则显示为”Edit”,若editing为YES,则显示为”Done”。


    可利用此按钮在设置UIViewController的editing状态时同时设置tableView的编辑状态。
    - (void)viewDidLoad {     [super viewDidLoad];     ....     self.navigationItem.rightBarButtonItem = self.editButtonItem; } -(void)setEditing:(BOOL)editing animated:(BOOL)animated {     [super setEditing:editing animated:animated];     [self.tableView setEditing:editing animated:animated]; }
  • 也可自定义其他按钮,将其响应设为修改tableView进入编辑模式。
    - (void)editAction:(id)sender {    [self.tableView setEditing:YES animated:YES]; }
  • UITableView接收到setEditing:animated:消息时,会发送同样的消息到所有可见的cell,设置其编辑模式。

    二.插入和删除

  • 进入编辑模式后,UITableView向其DataSource发送tableView:canEditRowAtIndexPath:消息询问每个indexPath是否可编辑,在此方法中对不可以编辑的cell返回NO,可以编辑的cell返回YES,若全部可编辑,可不实现,大部分应用不实现此方法。
    -(BOOL)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath {     if (indexPath.row == 1) {         return NO;     }     return YES; }
  • 然后,UITableView 向其delegate发送tableView:editingStyleForRowAtIndexPath:消息询问EditingStyle,这里返回删除(UITableViewCellEditingStyleDelete)或者插入(UITableViewCellEditingStyleInsert);若不实现此方法,则默认为删除模式,即UITableViewCellEditingStyleDelete。
    - (UITableViewCellEditingStyle)tableView:(UITableView *)tableView editingStyleForRowAtIndexPath:(NSIndexPath *)indexPath {     return UITableViewCellEditingStyleDelete;     //return UITableViewCellEditingStyleInsert; }

    当返回的是UITableViewCellEditingStyleDelete时,所有可编辑的Cell左侧都会显示红色的”减号”标示;

    点击左边的“减号”,减号会旋转90度变竖形,并且cell右侧出现”Delete”按钮。

    当返回的是UITableViewCellEditingStyleInsert时,在cell的左边会显示绿色”加号”按钮。

  • 当点击”Delete”按钮或者”加号”按钮时,UITableView向其DataSource发送tableView:commitEditingStyle:forRowAtIndexPath:消息,根据传递editingStyle来执行实际的删除或插入操作,其流程是先修改tableView的数据模型,向其中删除或插入对应数据项,然后再调整tableView的显示,删除或插入对应的cell。
    -(void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {     if (editingStyle == UITableViewCellEditingStyleDelete)     {         [dataArray removeObjectAtIndex:indexPath.row];         [tableview deleteRowsAtIndexPaths:[NSArray arrayWithObject:indexPath] withRowAnimation:UITableViewRowAnimationFade];     }else if(editingStyle == UITableViewCellEditingStyleInsert)     {         [dataArray insertObject:@"new Item" atIndex:indexPath.row];         [tableview insertRowsAtIndexPaths:[NSArray arrayWithObject:indexPath] withRowAnimation:UITableViewRowAnimationFade];     } }

    当要删除或插入section时,需调用deleteSections:withRowAnimation:insertSections:withRowAnimation:方法。

  • 插入删除流程的方法调用时序如图:
  • 三.重排序

  • 若当前tableView允许重排序,则会在每个cell的右侧出现三条灰色横线的控件,拖动此空间可将cell移动到不同的位置。重排序模式和删除/插入是并行的,即可在显示重排序空间的同时显示删除或插入控件。
  • 当tableView的dataSource实现tableView:moveRowAtIndexPath:toIndexPath:方法后,tableView进入编辑模式后就会在右侧显示“重排序”控件,如图所示。
  • 其消息处理流程为:
    1. tableView收到setEditing:animated:消息并将同样的消息发送给可见的cell。
    2. tableView向其DataSource发送tableView:canMoveRowAtIndexPath:消息,询问每一行是否可显示重排序空间,若为NO,则不显示,若为YES则显示。此方法不实现时默认所有行都可显示重排序控件。这时就会在每一行的右侧显示重排序控件。
      因为重排序没有使用向delegate发送tableView:editingStyleForRowAtIndexPath:消息询问编辑模式,所以其 与删除、插入控件可同时存在,在一般情况下不应该同时出现,所以应实现了 tableView:editingStyleForRowAtIndexPath:并返回 UITableViewCellEditingStyleNone;若不实现 tableView:editingStyleForRowAtIndexPath:则会默认使用删除模式,即右侧出现“排序”控件时,左侧会出现”删 除”控件。
    3. 用户可拖动每行右侧的空间来移动该行的位置。
    4. 用户拖动某行经过目标行上方时,tableView会向delegate发送tableView:targetIndexPathForMoveFromRowAtIndexPath:toProposedIndexPath:(若delegate有实现)消息询问是否可移动到此位置(ProposedIndexPath),若不可移动到此位置则返回一个新的目的indexPath,可以的话直接将ProposedIndexPath返回即可。一般情况下不需实现此方法。
      -(NSIndexPath *)tableView:(UITableView *)tableView targetIndexPathForMoveFromRowAtIndexPath:(NSIndexPath *)sourceIndexPath toProposedIndexPath:(NSIndexPath *)proposedDestinationIndexPath {     if (proposedDestinationIndexPath.row == 5) {         return [NSIndexPath indexPathForRow:8 inSection:0];      }     return proposedDestinationIndexPath; }
    5. tableView向其DataSource发送tableView:moveRowAtIndexPath:toIndexPath:消息,在此方法中更改tableView的数据模型,移动里面数据项的位置。
      - (void)tableView:(UITableView *)tableView moveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath{     if(sourceIndexPath == destinationIndexPath)         return;     id object = [dataArray objectAtIndex:sourceIndexPath.row];     [dataArray removeObjectAtIndex:sourceIndexPath.row];      [dataArray insertObject:object atIndex:destinationIndexPath.row]; }

    总体消息流程为:

  • 四.Swipe to Delete

  • 当用户在tableView的一行上滑动时,会在右侧直接出现删除按钮,点击删除按钮可删除此行。启用Swipe to Delete模式的条件时tableView的DataSource实现了tableView:commitEditingStyle:forRowAtIndexPath:方法;在iOS5中还要保证tableView的allowsMultipleSelectionDuringEditing属性不为YES(见后面解释)。
  • 满足上述条件后,当用户在tableView的行上滑动时,tableView会向自身发送setEditing:animated:消息进入编 辑模式,同时向可见的cell发送setEditing:animated:消息,在当前滑动的行右侧会出现红色”Delete”按钮。
  • 同样在点击”Delete”按钮时会向tableView的DataSource发送tableView:commitEditingStyle:forRowAtIndexPath:消息,执行实际的删除操作。
  • “Delete”按钮上显示的文字可以更改,包括普通删除模式下的”Delete”按钮。若要显示不同的内容,可在tableView Delegate中实现tableView:titleForDeleteConfirmationButtonForRowAtIndexPath:方法,返回”Delete”按钮中需要显示的内容
  • tableView在向自身发送setEditing:animated:消息的前后,会向其delegate分别发送tableView:willBeginEditingRowAtIndexPath: ,tableView:didEndEditingRowAtIndexPath:消息。在这些方法中可相应更新tableView的显示。How does the Twitter iPhone app implement side swiping on a table?中通过实现tableView:willBeginEditingRowAtIndexPath:方法使得用户在tableView的行上swipe时可滑出菜单。
  • 五.多行选取模式

    在iphone自带的邮件程序中,点击编辑按钮后会出现使用”红勾”多选的效果,如图所示

    有几种方法可以实现这种效果

    1.苹果公共API

  • 在iOS5.0中UITableView增加了allowsMultipleSelectionDuringEditing属性和indexPathsForSelectedRows方 法,allowsMultipleSelectionDuringEditing属性默认为NO,当此值为YES时,UITableView进入编辑模式 不会向dataSource查询editStyle,而会直接每个Cell的左边显示圆形选择框,点击选择该行后圆形框里面为对勾。可使用 indexPathsForSelectedRows方法获取到所有选择行的indexPath。
  • 苹果公司提供了使用此种方式的实例代码:TableMultiSelect
  • 注:当allowsMultipleSelectionDuringEditing属性为YES时,不管当前在不在编辑模式内,swipe to delete都不起作用,若要同时使用swipe to delete,需在完成选择任务后,将tableView的allowsMultipleSelectionDuringEditing恢复为NO。另 外,多选”控件可与”重排序”控件同时出现。
  • 2.苹果私用API

    在iOS5之前,苹果并没有提供多行选取的API,但其内部确实实现了,我们可以通过使用私有API实现。

    3.完全定制方法

    一些文章中介绍了不使用tableView本身的方法而完全自己定制实现多选效果的方法。
    如:Table View Multi-Row Edit Mode
    Multiple row selection and editing in a UITableView

    参考:
    Table View Programming Guide for iOS – Inserting and Deleting Rows and Sections
    Table View Programming Guide for iOS – Managing the Reordering of Rows
    UITableView Class Reference
    UITableViewDelegate Protocol Reference
    UITableViewDataSource Protocol Reference
    UITableViewCell Class Reference
    How does the Twitter iPhone app implement side swiping on a table?
    UITableView划动删除的实现
    UITableView多选删除,类似mail中的多选删除效果
    iPhone开发技巧之私有API(2)— UITableView
    iOS 5 Dev Warning: UITableView’s Multiple Select During Editing Doesn’t Work with Swipe to Delete
    Table View Multi-Row Edit Mode
    Multiple row selection and editing in a UITableView

      评论这张
     
    阅读(16703)| 评论(1)
    推荐 转载

    历史上的今天

    评论

    <#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
     
     
     
     
     
     
     
     
     
     
     
     
     
     

    页脚

    网易公司版权所有 ©1997-2018