Swift UICollectionView头部与主内容间距设置问题求助

我太懂这种钻了半天还是没搞定的憋屈感！你想给带头部的UICollectionView在头部和主内容之间加间距，用insetForSectionAt没达到预期对吧？给你几个亲测有效的解决思路：

如果你的UICollectionView只有一个Section，可以直接在代理方法里调整Section的顶部内边距，但要注意Section的内边距是作用于整个Section的容器（包含header、cell、footer），所以如果你的header有固定高度，这个top值就是header底部到第一个cell顶部的间距：

@objc(collectionView:layout:insetForSectionAtIndex:)
override func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets {
    // 这里的top值就是头部和内容之间的间距，比如设为20pt
    return UIEdgeInsets(top: 20, left: 0, bottom: 0, right: 0)
}

小提醒：如果你的header是自定义的，一定要确保referenceSizeForHeaderInSection返回了正确的高度，不然内边距的表现会混乱。

如果是多Section，或者不想依赖Section内边距，可以直接在自定义HeaderView里给内容加底部间距，这样不管哪个Section的header，都能和下方cell保持固定距离：

// 先在代理里设置header的尺寸
override func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForHeaderInSection section: Int) -> CGSize {
    return CGSize(width: collectionView.bounds.width, height: 50) // 自定义header高度
}

// 自定义HeaderView类
class CustomHeaderView: UICollectionReusableView {
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupSubviews()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupSubviews() {
        let titleLabel = UILabel()
        titleLabel.text = "Section Header"
        titleLabel.font = .systemFont(ofSize: 16, weight: .bold)
        addSubview(titleLabel)
        
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            titleLabel.topAnchor.constraint(equalTo: topAnchor, constant: 12),
            titleLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),
            // 这里的-20就是header内容到header底部的间距，也就是和下方cell的间距
            titleLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -20)
        ])
    }
}

如果不想修改HeaderView内部，也可以通过自定义FlowLayout来调整第一个cell的位置：

class CustomFlowLayout: UICollectionViewFlowLayout {
    override func layoutAttributesForElements(in rect: CGRect) -> [UICollectionViewLayoutAttributes]? {
        guard let attributes = super.layoutAttributesForElements(in: rect) else { return nil }
        
        attributes.forEach { attr in
            // 给每个Section的第一个cell顶部加上间距
            if attr.representedElementCategory == .cell && attr.indexPath.item == 0 {
                attr.frame.origin.y += 20
            }
        }
        return attributes
    }
}

有时候设置了代码却没效果，大概率是这些原因：

• 检查UICollectionView的contentInsetAdjustmentBehavior，如果设成了.automatic或.always，系统可能会自动调整内边距，建议暂时改成.never测试；
• 确认没有其他自定义Layout或第三方库覆盖了你的内边距设置；
• 检查referenceSizeForHeaderInSection是否返回了非零高度，如果header高度为0，内边自然不会有预期效果。

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