Swift开发：禁用UICollectionView内部滚动，实现整页滚动

要实现整页滚动，核心是把整个页面内容（餐厅信息+优惠券列表）放到UIScrollView容器里，让UICollectionView失去自身滚动能力，高度随内容自适应，最终由外部UIScrollView负责整页滚动。以下是具体实现步骤：

1. 重构布局结构，引入UIScrollView和内容容器 #

替换原来的直接布局，用UIScrollView作为主容器，内部嵌套一个contentView承载所有内容：

// 1. 创建UIScrollView作为主滚动容器
let scrollView = UIScrollView()
scrollView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(scrollView)

// 2. 创建contentView，作为scrollView的内容载体
let contentView = UIView()
contentView.translatesAutoresizingMaskIntoConstraints = false
scrollView.addSubview(contentView)

// 3. 用SnapKit设置约束
scrollView.snp.makeConstraints { make in
    make.edges.equalToSuperview() // 铺满整个ViewController的view
}

contentView.snp.makeConstraints { make in
    make.edges.equalToSuperview() // 和scrollView边缘对齐
    make.width.equalTo(scrollView.snp.width) // 固定宽度，避免横向滚动
}

2. 迁移餐厅信息控件到contentView #

把餐厅名称、描述、Logo、优惠券标题等控件全部添加到contentView上，设置垂直约束保证内容能撑起contentView高度：

// 示例：餐厅Logo约束
logoImageView.snp.makeConstraints { make in
    make.top.equalTo(contentView).offset(20)
    make.centerX.equalTo(contentView)
    make.size.equalTo(CGSize(width: 80, height: 80))
}

// 餐厅名称约束
restaurantNameLabel.snp.makeConstraints { make in
    make.top.equalTo(logoImageView.snp.bottom).offset(16)
    make.leading.trailing.equalTo(contentView).inset(16)
    make.centerX.equalTo(contentView)
}

// 餐厅描述约束
descriptionLabel.snp.makeConstraints { make in
    make.top.equalTo(restaurantNameLabel.snp.bottom).offset(8)
    make.leading.trailing.equalTo(contentView).inset(16)
}

// 优惠券标题约束
couponsTitle.snp.makeConstraints { make in
    make.top.equalTo(descriptionLabel.snp.bottom).offset(20)
    make.leading.trailing.equalTo(contentView).inset(16)
}

3. 调整UICollectionView的配置与约束 #

修改UICollectionView的布局设置，禁用自身滚动，并让高度随内容自适应：

3.1 修正CollectionView的注册代码（原代码有误） #

原代码注册的是UICollectionViewCell.self，但实际使用CouponCollectionCell，需修正：

let layout = UICollectionViewFlowLayout()
layout.scrollDirection = .vertical
// 若cell高度固定，直接设置itemSize；若高度动态，用自动计算
layout.itemSize = CGSize(width: UIScreen.main.bounds.width, height: 120) // 示例固定高度
// 动态高度请用：layout.estimatedItemSize = UICollectionViewFlowLayout.automaticSize

self.couponsCollectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
// 修正注册语句
couponsCollectionView!.register(CouponCollectionCell.self, forCellWithReuseIdentifier: CouponCollectionCell.reuseIdentifier)
couponsCollectionView!.isScrollEnabled = false // 禁用内部滚动
couponsCollectionView!.translatesAutoresizingMaskIntoConstraints = false
contentView.addSubview(couponsCollectionView!) // 添加到contentView而非原view

3.2 设置CollectionView的约束（关键：高度自适应） #

声明高度约束变量，初始设为0，后续根据内容更新：

// 类成员变量，用于后续更新高度
private var collectionViewHeightConstraint: Constraint?

// 设置CollectionView约束
couponsCollectionView!.snp.makeConstraints { make in
    make.top.equalTo(couponsTitle.snp.bottom)
    make.leading.trailing.equalTo(contentView)
    make.width.equalTo(contentView)
    // 初始高度设为0，后续更新为内容高度
    collectionViewHeightConstraint = make.height.equalTo(0).constraint
}

4. 数据加载完成后更新CollectionView高度 #

API返回优惠券数据并刷新CollectionView后，更新高度约束为CollectionView的contentSize.height：

// API请求完成后的回调示例
func loadCouponsSuccess(_ coupons: [CouponModel]) {
    self.couponData = coupons
    self.couponsCollectionView?.reloadData()
    
    // 等待布局完成后更新高度
    DispatchQueue.main.async { [weak self] in
        guard let self = self, let collectionView = self.couponsCollectionView else { return }
        // 更新高度约束为内容实际高度
        self.collectionViewHeightConstraint?.update(offset: collectionView.contentSize.height)
        // 强制刷新布局
        self.view.layoutIfNeeded()
    }
}

可选：监听contentSize变化（适配动态内容） #

如果cell高度可能动态变化，可监听CollectionView的contentSize属性自动更新高度：

// 在setupUI中添加观察者
couponsCollectionView!.addObserver(self, forKeyPath: "contentSize", options: .new, context: nil)

// 实现观察者方法
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard keyPath == "contentSize", let collectionView = object as? UICollectionView else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    // 自动更新高度
    collectionViewHeightConstraint?.update(offset: collectionView.contentSize.height)
    view.layoutIfNeeded()
}

// 销毁时移除观察者
deinit {
    couponsCollectionView?.removeObserver(self, forKeyPath: "contentSize")
}

关键注意事项 #

• 若使用动态高度cell，必须保证CouponCollectionCell的contentView内所有子控件的约束是从top到bottom完整链式的，确保系统能自动计算cell高度。
• 所有需要滚动的内容必须放在contentView内，否则无法跟随UIScrollView滚动。
• 原代码中couponsCollectionView!.alwaysBounceVertical = true可移除，因已禁用内部滚动，无需弹性效果。

内容的提问来源于stack exchange，提问作者Jiří Křenek