如何捕获未选中状态的UITabBarItem截图？

问题现象 #

当前代码仅能捕获选中状态的UITabBarItem截图：当selectedIndex设为0时，调用presentTooltip(forTabAtIndex: 0)能正常显示截图，但调用presentTooltip(forTabAtIndex: 1)无内容渲染；切换selectedIndex为1后，index=0的截图失效，index=1的截图恢复正常。

问题根源 #

1. 坐标系错误：UIView的snapshot扩展中，drawHierarchy(in: frame, ...)使用了视图的frame（相对父视图的坐标），而非bounds（视图自身坐标系的矩形），导致未选中item的内容被绘制到快照外部，最终呈现空白。
2. 渲染时机问题：未选中的UITabBarItem可能因系统优化未完成完整渲染，直接截图无法捕获到内容。
3. 子视图筛选不稳定：通过subviews筛选UIControl的方式依赖UITabBar的内部结构，不同iOS版本可能出现匹配错误。

解决方案 #

1. 修正UIView快照的绘制坐标系与渲染时机 #

修改UIView的snapshot扩展，确保使用自身坐标系并触发最新渲染：

extension UIView {
    var globalFrame: CGRect {
        superview?.convert(frame, to: nil) ?? .zero
    }
    
    var snapshot: UIImage {
        // 强制触发视图布局完成
        layoutIfNeeded()
        return UIGraphicsImageRenderer(size: bounds.size).image { _ in
            // 使用bounds确保在视图自身坐标系内绘制
            drawHierarchy(in: bounds, afterScreenUpdates: true)
        }
    }
}

2. 稳定获取UITabBarItem对应的视图 #

通过UITabBarItem的私有view属性直接获取对应按钮（适配不同iOS版本），替换原有的子视图筛选逻辑：

extension UITabBar {
    func snapshotDataForTab(atIndex index: Int) -> (UIImage, CGRect)? {
        guard let items = items, index < items.count else { return nil }
        guard let tabButton = items[index].value(forKey: "view") as? UIView else { return nil }
        
        return (tabButton.snapshot, tabButton.globalFrame)
    }
}

3. 优化主控制器的弹窗逻辑 #

处理可选值，同时调整遮罩层样式提升可读性：

class MainTabBarController: UITabBarController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        selectedIndex = 0
    }
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        DispatchQueue.main.asyncAfter(deadline: .now() + 2) {
            self.presentTooltip(forTabAtIndex: 1) // 测试未选中item
        }
    }
    
    private func presentTooltip(forTabAtIndex index: Int) {
        let dimView = UIView(frame: view.bounds)
        dimView.backgroundColor = UIColor.black.withAlphaComponent(0.7)
        view.addSubview(dimView)
        
        guard let (image, frame) = tabBar.snapshotDataForTab(atIndex: index) else { return }
        let imageView = UIImageView(image: image)
        imageView.frame = frame
        dimView.addSubview(imageView)
    }
}

关键说明 #

• bounds vs frame：drawHierarchy方法需要的是视图自身坐标系内的矩形范围，使用frame会导致内容偏移到快照画布外，从而出现空白。
• afterScreenUpdates: true：确保视图的最新状态（包括未选中item的样式）被绘制到快照中，避免因系统延迟渲染导致的空白。
• 直接获取TabBarItem视图：绕过subviews的不稳定筛选，通过UITabBarItem关联的视图直接操作，提升代码在不同iOS版本的兼容性。

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