如何让UIKit中自定义Detent高度与UISheetPresentationController内容对齐？

核心思路 #

不用硬编码常量高度，让弹窗的自定义Detent高度动态绑定弹窗内部内容的实际高度——弹窗ViewController本身能直接获取内部UICollectionView第一分区的布局高度，把这个高度同步给Detent即可，完美适配字体大小变化、内容动态调整等场景。

具体实现步骤 #

1. 自定义动态高度的Detent

创建一个基于内容高度的自定义Detent，利用UISheetPresentationController.Detent.custom的闭包特性，实时获取弹窗内的目标高度：

extension UISheetPresentationController.Detent {
    static func contentHeightDetent(heightProvider: @escaping () -> CGFloat) -> Self {
        return .custom { context in
            let targetHeight = heightProvider()
            // 确保高度不小于系统最小Detent高度（可选，按需调整）
            return max(targetHeight, context.minimumDetentValue)
        }
    }
}

2. 在弹窗ViewController中管理内容高度

在弹窗VC里，实现计算UICollectionView第一分区实际高度的方法，同时监听布局变化和字体大小变化，及时更新Detent：

class PopupViewController: UIViewController {
    @IBOutlet weak var collectionView: UICollectionView!
    
    // 存储当前第一分区的高度，供Detent调用
    private var firstSectionHeight: CGFloat = 0
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 监听字体大小变化
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(updateContentHeight),
            name: UIContentSizeCategory.didChangeNotification,
            object: nil
        )
        // 监听CollectionView布局更新
        collectionView.addObserver(
            self,
            forKeyPath: "contentSize",
            options: [.new],
            context: nil
        )
    }
    
    override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        if keyPath == "contentSize" {
            updateContentHeight()
        }
    }
    
    @objc private func updateContentHeight() {
        // 计算第一分区的实际高度
        guard let layout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout,
              let sectionCount = collectionView.dataSource?.numberOfSections?(in: collectionView),
              sectionCount > 0 else {
            firstSectionHeight = 0
            return
        }
        
        let sectionInsets = layout.sectionInset
        let headerHeight = layout.headerReferenceSize.height
        let footerHeight = layout.footerReferenceSize.height
        
        // 累加第一分区所有item的高度和间距
        let itemCount = collectionView.dataSource?.collectionView(collectionView, numberOfItemsInSection: 0) ?? 0
        var itemsTotalHeight: CGFloat = 0
        for itemIndex in 0..<itemCount {
            let indexPath = IndexPath(item: itemIndex, section: 0)
            if let attributes = layout.layoutAttributesForItem(at: indexPath) {
                itemsTotalHeight += attributes.frame.height
                if itemIndex < itemCount - 1 {
                    itemsTotalHeight += layout.minimumInteritemSpacing
                }
            }
        }
        
        // 计算整个第一分区的总高度
        firstSectionHeight = sectionInsets.top + headerHeight + itemsTotalHeight + footerHeight + sectionInsets.bottom
        
        // 更新Sheet的Detents，触发高度刷新
        sheetPresentationController?.detents = [
            .contentHeightDetent(heightProvider: { [weak self] in
                self?.firstSectionHeight ?? 0
            }),
            .large() // 可选，添加全屏高度的Detent
        ]
    }
    
    deinit {
        NotificationCenter.default.removeObserver(self)
        collectionView.removeObserver(self, forKeyPath: "contentSize")
    }
}

3. 配置弹窗的基础样式（不阻挡底层交互、不变暗）

在展示弹窗时，设置sheetPresentationController的相关属性，确保底层ViewController可以正常交互：

let popupVC = PopupViewController()
popupVC.modalPresentationStyle = .pageSheet

if let sheet = popupVC.sheetPresentationController {
    sheet.prefersGrabberVisible = true // 显示顶部拖拽条
    sheet.largestUndimmedDetentIdentifier = .custom // 所有Detent状态下都不遮挡底层视图交互
    sheet.prefersScrollingExpandsWhenScrolledToEdge = false // 禁止滚动自动展开
    sheet.widthFollowsPreferredContentSizeWhenEdgeAttached = true // 适配内容宽度
}

present(popupVC, animated: true)

关键注意事项 #

• 如果UICollectionView使用自定义布局（非FlowLayout），需要调整updateContentHeight里的高度计算逻辑，确保能准确获取第一分区的实际高度。
• 当弹窗内容动态更新（比如加载新数据）时，记得手动调用updateContentHeight()来同步Detent高度。
• 使用weak self避免循环引用，尤其是在Detent的闭包中。

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