Swift-UITableView滑动操作（Swipe Actions）

在iOS8之后，苹果官方增加了UITableVIew的左滑操作接口，即新增了一个代理方法(tableView: editActionsForRowAtIndexPath:)，代理方法返回的是一个数组，我们可以在这个代理方法中定义所需要的操作按钮(删除、置顶等)，这些按钮的类就是UITableViewRowAction。这个类只能定义按钮的显示文字、背景色、和按钮事件。并且返回数组的第一个元素在UITableViewCell的最右侧显示，最后一个元素在最左侧显示。

一、左滑出现删除按钮

实现两个代理方法：设置按钮事件和标题

   func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCellEditingStyle, forRowAt indexPath: IndexPath) {
        // 当点击了删除按钮
        dataSource.removeObject(at: indexPath.row)
        // 刷新
        tableView.deleteRows(at: [indexPath], with: UITableViewRowAnimation.bottom)
    }
    
    // 返回删除按钮标题
    func tableView(_ tableView: UITableView, titleForDeleteConfirmationButtonForRowAt indexPath: IndexPath) -> String? {
        return "我喜欢你";
    }
    
    func tableView(_ tableView: UITableView, editingStyleForRowAt indexPath: IndexPath) -> UITableViewCellEditingStyle {
        // 默认就是删除样式
        return UITableViewCellEditingStyle.delete
    }

二、左滑出现多个按钮

func tableView(_ tableView: UITableView, editActionsForRowAt indexPath: IndexPath) -> [UITableViewRowAction]? {
        // 上移
        let shareAction:UITableViewRowAction = UITableViewRowAction(style: UITableViewRowActionStyle.default, title: "上移") { (action, indexPath) in
            
            customLog("点击了 \(String(describing: action.title)) - \(indexPath)")
        
            // 移动
            if indexPath.row != 0{
                let toIndexPath:IndexPath = IndexPath(row: indexPath.row - 1, section: indexPath.section)
                tableView.moveRow(at: indexPath, to: toIndexPath as IndexPath)
            }
        }
        // 下移
        let addAction:UITableViewRowAction = UITableViewRowAction(style: UITableViewRowActionStyle.default, title: "下移") { (action, indexPath) in
            customLog("点击了 \(action.title ?? "第二个按钮") - \(indexPath)")
            
            // 移动
            if indexPath.row != self.dataSource.count-1{
                let toIndexPath:IndexPath = IndexPath(row: indexPath.row + 1, section: indexPath.section)
                tableView.moveRow(at: indexPath, to: toIndexPath as IndexPath)
            }
        }
        // 删除
        let deleteAction:UITableViewRowAction = UITableViewRowAction(style: UITableViewRowActionStyle.default, title: "删除") { (action, indexPath) in
            customLog("点击了 \(String(describing: action.title)) - \(indexPath)")

            // 当点击了删除按钮
            self.dataSource.removeObject(at: indexPath.row)
            // 刷新
            tableView.deleteRows(at: [indexPath], with: UITableViewRowAnimation.bottom)
        }

        // 第一个显示在最右边
        return [deleteAction,shareAction,addAction]
    }


// DataSource
    func tableView(_ tableView: UITableView, canMoveRowAt indexPath: IndexPath) -> Bool {
        return true
    }
    func tableView(_ tableView: UITableView, moveRowAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
        // 移动行的时候做一些处理
    }
    
    // Delegate
    func tableView(_ tableView: UITableView, shouldIndentWhileEditingRowAt indexPath: IndexPath) -> Bool {
        // 编辑状态下的Cell是否需要缩进
        return true
    }
    
    func tableView(_ tableView: UITableView, willBeginEditingRowAt indexPath: IndexPath) {
        // 开始编辑
    }
    
    func tableView(_ tableView: UITableView, didEndEditingRowAt indexPath: IndexPath?) {
        // 结束编辑
    }

三、iOS 11更新

iOS 11开始有了一些更新，首先是可以给这些按钮添加图片了，然后是如果实现了以下两个iOS 11新增的代理方法，将会取代(tableView: editActionsForRowAtIndexPath:)代理方法。

@available(iOS 11.0, *)
    func tableView(_ tableView: UITableView, trailingSwipeActionsConfigurationForRowAt indexPath: IndexPath) -> UISwipeActionsConfiguration? {
        
        let deleteAction:UIContextualAction = UIContextualAction(style: .destructive, title: "删除") { (action, sourceView, completionHandler) in
            completionHandler(true)
        }
        //delete操作按钮可使用UIContextualActionStyleDestructive类型，当使用该类型时，如果是右滑操作，一直向右滑动某个cell，会直接执行删除操作，不用再点击删除按钮。
        deleteAction.backgroundColor = UIColor.red
        deleteAction.image = UIImage(named: "delete")
        
        let actions:[UIContextualAction] = [deleteAction]
        
        let action:UISwipeActionsConfiguration = UISwipeActionsConfiguration(actions: actions)
        // 当一直向右滑是会执行第一个action
        action.performsFirstActionWithFullSwipe = true
        
        return action
    }
    
    @available(iOS 11.0, *)
    func tableView(_ tableView: UITableView, leadingSwipeActionsConfigurationForRowAt indexPath: IndexPath) -> UISwipeActionsConfiguration? {
        
    }

四、MGSwipeTableCell

低于iOS 11的系统UITableViewRowAction只有标题不能添加图片,并且没有提供滑出的API，并且在iOS 11和iOS < 11的系统按钮层次不一样(iOS 11按钮加在TableView上，< 11在UITableViewCell上),自定义起来比较麻烦。

MGSwipeTableCell可以加载多个按钮支持左滑rightButtons或者右滑leftButtons，可以自己设置动画效果自定义事件调出滑出效果，通过代理MGSwipeTableCellDelegate监听按钮点击。

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell
{
    let reuseIdentifier = "programmaticCell"
    var cell = tableView.dequeueReusableCell(withIdentifier: reuseIdentifier, for: indexPath) as! MGSwipeTableCell

    cell.textLabel!.text = "Title"
    cell.detailTextLabel!.text = "Detail text"
    cell.delegate = self //optional

    //configure left buttons
    cell.leftButtons = [MGSwipeButton(title: "", icon: UIImage(named:"check.png"), backgroundColor: .green),
                        MGSwipeButton(title: "", icon: UIImage(named:"fav.png"), backgroundColor: .blue)]
    cell.leftSwipeSettings.transition = .rotate3D

    //configure right buttons
    cell.rightButtons = [MGSwipeButton(title: "Delete", backgroundColor: .red),
                         MGSwipeButton(title: "More",backgroundColor: .lightGray)]
    cell.rightSwipeSettings.transition = .rotate3D

    return cell
}