30. UITableViewDelegate详解

UITableViewDelegate

它用于表现cell的显示和行为,我们查看它的定义:

public protocol UITableViewDelegate : NSObjectProtocol, UIScrollViewDelegate {    // 自定义显示    // cell将要显示时回调    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, willDisplayCell cell: UITableViewCell, forRowAtIndexPath indexPath: NSIndexPath)     // section的header将要显示时回调    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, willDisplayHeaderView view: UIView, forSection section: Int)    // section的footer将要显示时回调    @available(iOS 6.0, *)     optional public func tableView(tableView: UITableView, willDisplayFooterView view: UIView, forSection section: Int)    // cell已显示时回调    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, didEndDisplayingCell cell: UITableViewCell, forRowAtIndexPath indexPath: NSIndexPath)    // section的header已显示时回调    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, didEndDisplayingHeaderView view: UIView, forSection section: Int)    // section的footer已显示时回调    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, didEndDisplayingFooterView view: UIView, forSection section: Int)    // 可变高度的支持    // 返回行高    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, heightForRowAtIndexPath indexPath: NSIndexPath) -> CGFloat    // 返回section的header的高度    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat    // 返回section的footer的高度    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, heightForFooterInSection section: Int) -> CGFloat    // 使用estimatedHeight方法可以快速计算猜测值,可加快table的加载时间    // 如果下面的这些estimatedHeight方法被实现, 上面的tableView:heightForXXX的调用将被推迟到views可以被展示的时候,所以这里可以放一些相对耗资源的逻辑    // 返回预估的行高    @available(iOS 7.0, *)    optional public func tableView(tableView: UITableView, estimatedHeightForRowAtIndexPath indexPath: NSIndexPath) -> CGFloat    // 返回预估 section的header 高度    @available(iOS 7.0, *)    optional public func tableView(tableView: UITableView, estimatedHeightForHeaderInSection section: Int) -> CGFloat    @available(iOS 7.0, *)    // 返回预估 section的footer 高度    optional public func tableView(tableView: UITableView, estimatedHeightForFooterInSection section: Int) -> CGFloat    // Section的header和footer信息    // 返回自定义的 section的header, 它将调整默认或已经指定的header的高度    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, viewForHeaderInSection section: Int) -> UIView?     // 返回自定义的 section的footer, 它将调整默认或已经指定的footer的高度    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, viewForFooterInSection section: Int) -> UIView?     // 行右侧的图标被点击的时候的回调     @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, accessoryButtonTappedForRowWithIndexPath indexPath: NSIndexPath)    // Selection    // -tableView:shouldHighlightRowAtIndexPath: 这个方法将被调用当有行被按下的时候    // 返回false,消息将停止发送而导致当前行在按下的时候不是失去选中时的高亮    // 将要高亮的时候调用    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, shouldHighlightRowAtIndexPath indexPath: NSIndexPath) -> Bool    // 已经高亮的时候调用    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, didHighlightRowAtIndexPath indexPath: NSIndexPath)    // 已经不高亮的时候调用    @available(iOS 6.0, *)    optional public func tableView(tableView: UITableView, didUnhighlightRowAtIndexPath indexPath: NSIndexPath)    // 在用户改变选中前调用, 返回一个新的indexPath或nil    // 将要选中行    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, willSelectRowAtIndexPath indexPath: NSIndexPath) -> NSIndexPath?    // 将要取消选中行    @available(iOS 3.0, *)    optional public func tableView(tableView: UITableView, willDeselectRowAtIndexPath indexPath: NSIndexPath) -> NSIndexPath?    // 改变选中后调用.    // 选中后调用    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath)    // 已经取消选中后调用    @available(iOS 3.0, *)    optional public func tableView(tableView: UITableView, didDeselectRowAtIndexPath indexPath: NSIndexPath)    // 编辑模式    // 允许给indexPath的cell自定义editingStyle, 如果没有实现下面的方法,那么当editing属性设置为true时,所有的可编辑cell都有UITableViewCellEditingStyleDelete风格    // 指定cell的编辑风格    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, editingStyleForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCellEditingStyle    // 删除时弹出的确认按钮的文字    @available(iOS 3.0, *)    optional public func tableView(tableView: UITableView, titleForDeleteConfirmationButtonForRowAtIndexPath indexPath: NSIndexPath) -> String?    // 如果返回值为非nil,将取代tableView:titleForDeleteConfirmationButtonForRowAtIndexPath:    @available(iOS 8.0, *)    optional public func tableView(tableView: UITableView, editActionsForRowAtIndexPath indexPath: NSIndexPath) -> [UITableViewRowAction]?     // 控制在编辑模式下背景是否缩进. 如果没有实现, 默认是true,它和下面的缩进级别无关, 这个方法只能用于grouped风格的tableView    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, shouldIndentWhileEditingRowAtIndexPath indexPath: NSIndexPath) -> Bool    // 当insert/delete/move按钮将要显示的时候回调    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, willBeginEditingRowAtIndexPath indexPath: NSIndexPath)    // 编辑完成后回调    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, didEndEditingRowAtIndexPath indexPath: NSIndexPath)    // 移动和重新排序    // 允许指定行移动到目标行    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, targetIndexPathForMoveFromRowAtIndexPath sourceIndexPath: NSIndexPath, toProposedIndexPath proposedDestinationIndexPath: NSIndexPath) -> NSIndexPath    // Indentation(压痕)    // 返回压痕个深度等级    @available(iOS 2.0, *)    optional public func tableView(tableView: UITableView, indentationLevelForRowAtIndexPath indexPath: NSIndexPath) -> Int     // 使用复制/粘贴功能, 下面的三个方法必须都实现    // 是否将要显示系统菜单(用于复制/粘贴)    @available(iOS 5.0, *)    optional public func tableView(tableView: UITableView, shouldShowMenuForRowAtIndexPath indexPath: NSIndexPath) -> Bool    // 是否确认显示系统菜单    @available(iOS 5.0, *)    optional public func tableView(tableView: UITableView, canPerformAction action: Selector, forRowAtIndexPath indexPath: NSIndexPath, withSender sender: AnyObject?) -> Bool    // 当用户选择菜单中的某个选项时调用    @available(iOS 5.0, *)    optional public func tableView(tableView: UITableView, performAction action: Selector, forRowAtIndexPath indexPath: NSIndexPath, withSender sender: AnyObject?)    // 获得焦点    // 返回能否获得焦点    @available(iOS 9.0, *)    optional public func tableView(tableView: UITableView, canFocusRowAtIndexPath indexPath: NSIndexPath) -> Bool    // 返回是否将要更新焦点    @available(iOS 9.0, *)    optional public func tableView(tableView: UITableView, shouldUpdateFocusInContext context: UITableViewFocusUpdateContext) -> Bool    // 已经更新焦点时调用    @available(iOS 9.0, *)    optional public func tableView(tableView: UITableView, didUpdateFocusInContext context: UITableViewFocusUpdateContext, withAnimationCoordinator coordinator: UIFocusAnimationCoordinator)    // 返回上一个焦点的indexPath    @available(iOS 9.0, *)    optional public func indexPathForPreferredFocusedViewInTableView(tableView: UITableView) -> NSIndexPath?}