如何在UIContextualAction侧滑菜单完全消失后执行操作？

我实现了如下简单的UIContextualAction侧滑操作：

let action = UIContextualAction(style: .normal, title: "View Details", handler: { (action, view, completionHandler) in
     viewModel.doSomething(with:...)

     completionHandler(true)
 })

根据官方文档，handler是用户选择操作时触发的回调块，但它仅接受Bool类型参数。我希望在操作菜单完全消失（自动滑回动画完成后）再执行特定操作，而非点击操作按钮时立即执行。请问是否有原生方案实现，还是需要自定义workaround？

目前UIKit没有提供直接监听UIContextualAction菜单消失完成的原生回调，需要通过自定义方案实现，以下是三种可行的workaround：

方案一：固定延迟匹配系统动画时长 #

UIKit侧滑菜单的消失动画默认时长为0.3秒，在调用completionHandler(true)后延迟对应时长执行目标操作：

let action = UIContextualAction(style: .normal, title: "View Details", handler: { (action, view, completionHandler) in
    completionHandler(true)
    
    // 延迟0.3秒，对齐系统动画完成时机
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) { [weak self] in
        self?.viewModel.doSomething(with: ...)
    }
})

这种方式实现最简单，但缺点是如果系统后续调整动画时长，代码需要同步修改。

方案二：监听单元格动画完成事件 #

侧滑菜单消失时，对应列表单元格会执行滑回原位的布局动画，通过监听该动画的完成事件触发操作：

// 定义集合标记待处理的单元格索引，避免重复执行
private var pendingIndexPaths = Set<IndexPath>()

let action = UIContextualAction(style: .normal, title: "View Details", handler: { [weak self] (action, view, completionHandler) in
    guard let self = self, let cell = view.superview?.superview as? UITableViewCell, let indexPath = self.tableView.indexPath(for: cell) else {
        completionHandler(true)
        return
    }
    
    self.pendingIndexPaths.insert(indexPath)
    completionHandler(true)
    
    // 触发并监听单元格布局动画
    UIView.animate(withDuration: 0.3, animations: {
        cell.layoutIfNeeded()
    }, completion: { [weak self] _ in
        guard let self = self else { return }
        if self.pendingIndexPaths.contains(indexPath) {
            self.viewModel.doSomething(with: ...)
            self.pendingIndexPaths.remove(indexPath)
        }
    })
})

这种方式更贴合系统动画的实际完成时机，比固定延迟更可靠。

方案三：KVO监听单元格编辑状态 #

列表单元格在侧滑菜单展开时isEditing为true，菜单消失后恢复为false，通过KVO监听该状态变化捕获菜单消失时机：

// 定义上下文标识和待执行操作的存储变量
private var editingObservationContext = 0
private var pendingAction: (() -> Void)?

let action = UIContextualAction(style: .normal, title: "View Details", handler: { [weak self] (action, view, completionHandler) in
    guard let self = self, let cell = view.superview?.superview as? UITableViewCell else {
        completionHandler(true)
        return
    }
    
    // 记录待执行的操作
    self.pendingAction = { [weak self] in
        self?.viewModel.doSomething(with: ...)
    }
    
    // 添加KVO监听
    cell.addObserver(self, forKeyPath: "isEditing", options: .new, context: &self.editingObservationContext)
    completionHandler(true)
})

// 实现KVO回调方法
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard context == &editingObservationContext, keyPath == "isEditing", let cell = object as? UITableViewCell, !cell.isEditing else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    
    // 移除监听并执行目标操作
    cell.removeObserver(self, forKeyPath: "isEditing", context: &editingObservationContext)
    pendingAction?()
    pendingAction = nil
}

注意：使用KVO时必须确保在合适时机移除监听，避免内存泄漏。

内容的提问来源于stack exchange，提问作者Whirlwind