UIViewControllerAnimatedTransitioning中Snapshot视图隐藏问题求助

我来帮你搞定这个转场动画的问题！你遇到的快照在动画期间看不见的情况，大概率是快照的层级、添加时机或者frame计算出了问题，结合你明确要用toViewController的快照来做UILabel转场的需求，我整理了一套靠谱的实现方案：

先排查快照不可见的核心原因 #

• 容器视图选错了：必须把快照添加到转场上下文的containerView，而不是fromVC或toVC的视图里，否则会被控制器视图的层级直接遮挡。
• 快照时机不对：要确保toViewController的view已经完成加载，才能正确获取UILabel的快照（别在view还没加载的时候就取快照，那肯定是空的）。
• Frame坐标系没转换：两个控制器中UILabel的frame是各自视图的坐标系，必须转换成容器视图的坐标系，不然位置肯定错，快照可能在屏幕外。

完整实现代码 #

首先创建自定义转场动画类，遵循UIViewControllerAnimatedTransitioning协议：

import UIKit

class LabelTransitionAnimator: NSObject, UIViewControllerAnimatedTransitioning {
    // 转场时长，可按需调整
    func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval {
        return 0.5
    }
    
    func animateTransition(using transitionContext: UIViewControllerContextTransitioning) {
        // 获取转场前后的控制器，以及两个要过渡的UILabel
        guard let fromVC = transitionContext.viewController(forKey: .from),
              let toVC = transitionContext.viewController(forKey: .to),
              let fromLabel = fromVC.view.viewWithTag(100) as? UILabel, // 这里假设fromVC的label tag设为100
              let toLabel = toVC.view.viewWithTag(200) as? UILabel else { // toVC的label tag设为200
            transitionContext.completeTransition(false)
            return
        }
        
        // 强制加载toVC的view，避免还没加载就取快照
        toVC.loadViewIfNeeded()
        let containerView = transitionContext.containerView
        
        // 获取toVC中label的快照（完全符合你的需求）
        let toLabelSnapshot = toLabel.snapshotView(afterScreenUpdates: true)!
        // 先把快照的frame设置成fromLabel在容器视图中的位置，作为动画起点
        let fromLabelFrameInContainer = fromVC.view.convert(fromLabel.frame, to: containerView)
        toLabelSnapshot.frame = fromLabelFrameInContainer
        // 先隐藏toVC的原始label，避免和快照重叠
        toLabel.isHidden = true
        
        // 注意添加顺序：先加toVC的view，再加快照，这样快照在视觉层级上方
        containerView.addSubview(toVC.view)
        containerView.addSubview(toLabelSnapshot)
        // 初始时toVC的view透明，动画结束再显示
        toVC.view.alpha = 0
        
        // 执行动画
        UIView.animate(withDuration: transitionDuration(using: transitionContext), animations: {
            // 把快照移动到toLabel在容器视图中的位置，作为动画终点
            let toLabelFrameInContainer = toVC.view.convert(toLabel.frame, to: containerView)
            toLabelSnapshot.frame = toLabelFrameInContainer
            // 同时淡入toVC的视图
            toVC.view.alpha = 1
        }) { finished in
            // 动画结束后，显示toVC的原始label，移除快照
            toLabel.isHidden = false
            toLabelSnapshot.removeFromSuperview()
            // 标记转场完成（记得处理取消的情况）
            transitionContext.completeTransition(!transitionContext.transitionWasCancelled)
        }
    }
}

然后在发起转场的控制器（第一个VC）中设置转场代理：

class FirstViewController: UIViewController {
    // 假设你用segue跳转，在prepare里设置代理
    override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
        if let secondVC = segue.destination as? SecondViewController {
            secondVC.transitioningDelegate = self
        }
    }
}

// 扩展实现转场代理
extension FirstViewController: UIViewControllerTransitioningDelegate {
    func animationController(forPresented presented: UIViewController, presenting: UIViewController, source: UIViewController) -> UIViewControllerAnimatedTransitioning? {
        return LabelTransitionAnimator()
    }
}

关键步骤解释 #

• 快照层级控制：先添加toVC的view，再加快照，确保快照在最上层，不会被toVC的视图挡住。
• 坐标系转换：用convert(_:to:)把label的frame转换成容器视图的坐标系，这是转场动画中位置正确的核心。
• 视图显隐控制：动画开始隐藏原始label，用快照做过渡，结束后再显示原始label，保证最终交互的是真实的UILabel。
• 强制加载视图：loadViewIfNeeded()确保toVC的view已经加载完成，否则无法获取到有效的快照。

额外调试技巧 #

如果快照还是看不见，可以临时给快照加个背景色（比如toLabelSnapshot.backgroundColor = .orange），这样能快速排查快照的位置是否正确，是不是跑到屏幕外面去了。

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