iOS15+ UIKit集合视图应用的现代键盘布局适配方案问询

核心思路 #

通过正确配置UIKeyboardLayoutGuide与CollectionView的约束优先级，结合单元格自尺寸设置和文本变化时的主动刷新，解决键盘弹出/文本编辑时的UI适配问题。

一、正确设置CollectionView的布局约束 #

之前的约束方式要么层级错误，要么缺少 fallback 导致布局异常，正确的约束配置如下：

• 让CollectionView的顶部、左右边贴紧安全区域
• 优先将底部约束绑定到keyboardLayoutGuide.topAnchor（高优先级），同时添加低优先级约束绑定到安全区域底部，确保键盘隐藏时CollectionView正常贴底

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 初始化列表布局（确保是Compositional Layout的列表样式）
    let listConfig = UICollectionLayoutListConfiguration(appearance: .insetGrouped)
    collectionView.collectionViewLayout = UICollectionViewCompositionalLayout.list(using: listConfig)
    
    // iOS16+ 开启自尺寸自动刷新
    collectionView.selfSizingInvalidation = .enabled
    collectionView.contentInsetAdjustmentBehavior = .automatic
    
    // 添加约束
    collectionView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        collectionView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        collectionView.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor),
        collectionView.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor),
        // 高优先级：键盘弹出时贴键盘顶部
        collectionView.bottomAnchor.constraint(equalTo: view.keyboardLayoutGuide.topAnchor).withPriority(.defaultHigh),
        // 低优先级：键盘隐藏时贴安全区域底部
        collectionView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor).withPriority(.defaultLow)
    ])
    
    // 注册单元格、配置Diffable DataSource...
}

二、TextView单元格的自尺寸配置 #

确保TextView的约束完全贴合单元格内容视图，且禁用滚动，让单元格能根据文本内容自动调整尺寸：

class TextViewCollectionViewCell: UICollectionViewListCell {
    let textView = UITextView()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupTextView()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupTextView()
    }
    
    private func setupTextView() {
        textView.translatesAutoresizingMaskIntoConstraints = false
        textView.isScrollEnabled = false // 必须禁用滚动，否则单元格无法自尺寸
        textView.font = UIFont.preferredFont(forTextStyle: .body)
        contentView.addSubview(textView)
        
        // 四边添加内边距约束，确保文本不会贴单元格边缘
        NSLayoutConstraint.activate([
            textView.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 16),
            textView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            textView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            textView.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -16)
        ])
        
        // 监听文本变化，主动触发单元格尺寸更新
        textView.addTarget(self, action: #selector(textDidChange), for: .editingChanged)
    }
    
    @objc private func textDidChange() {
        // 刷新当前单元格，触发自尺寸重新计算
        guard let collectionView = superview as? UICollectionView,
              let indexPath = collectionView.indexPath(for: self) else { return }
        
        collectionView.performBatchUpdates({
            collectionView.reloadItems(at: [indexPath])
        }, completion: nil)
    }
}

三、解决iOS17的偏移与标签栏异常问题 #

如果你的页面带有TabBar，需要额外设置：

override func viewDidLoad() {
    super.viewDidLoad()
    // 允许布局延伸到不透明的TabBar下方，避免标签栏变黑
    extendedLayoutIncludesOpaqueBars = true
}

为什么之前的方法失败？ #

1. 方法1：单元格属于CollectionView的子视图，与ViewController的keyboardLayoutGuide不在同一视图层级，跨层级约束会直接失效。
2. 方法2：缺少低优先级的安全区域底部约束，键盘隐藏时CollectionView的底部会悬空，导致布局异常。
3. 方法3：没有设置约束优先级，且未处理安全区域与TabBar的关系，iOS17中布局引擎会出现冲突，导致UI偏移和标签栏被覆盖。

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