点击CollectionView单元格按钮后批量修改所有按钮背景色的实现疑问

这个问题我做项目时也碰到过，核心是要绕开CollectionView的Cell复用特性——直接修改当前可见按钮的颜色是没用的，滑出屏幕的Cell复用后状态会乱，所以得靠全局状态驱动+Cell配置的方式来实现，下面是具体的解决方案：

一、核心思路 #

1. 维护一个全局状态变量，用来记录按钮的目标状态（比如选中的按钮位置，或者统一的背景色）；
2. 给自定义Cell写一个配置方法，根据全局状态设置按钮的背景色；
3. 点击按钮时更新全局状态，然后刷新CollectionView（或仅刷新可见Cell），让所有Cell根据新状态重新配置。

二、具体代码实现 #

1. 自定义CollectionViewCell #

首先我们需要一个自定义Cell，把按钮的配置逻辑封装起来，同时用闭包（或代理）把按钮点击事件传递给ViewController：

import UIKit

class CustomButtonCell: UICollectionViewCell {
    @IBOutlet weak var actionButton: UIButton!
    
    // 闭包：用来通知ViewController按钮被点击了
    var buttonTapHandler: (() -> Void)?
    
    // 配置方法：根据外部传入的状态设置按钮样式
    func setup(with isSelected: Bool) {
        actionButton.backgroundColor = isSelected ? .systemGreen : .systemGray
        // 也可以加个圆角优化样式
        actionButton.layer.cornerRadius = 8
    }
    
    @IBAction func onButtonTapped(_ sender: UIButton) {
        // 触发闭包，通知外部
        buttonTapHandler?()
    }
}

2. ViewController中的逻辑 #

在ViewController里，我们维护全局状态，实现CollectionView的数据源方法，并处理按钮点击后的状态更新：

import UIKit

class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegateFlowLayout {
    
    @IBOutlet weak var collectionView: UICollectionView!
    
    // 全局状态：记录当前选中的按钮所在的IndexPath
    private var selectedCellIndexPath: IndexPath?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupCollectionView()
    }
    
    private func setupCollectionView() {
        collectionView.dataSource = self
        collectionView.delegate = self
        // 注册自定义Cell（如果用XIB的话）
        collectionView.register(UINib(nibName: "CustomButtonCell", bundle: nil), forCellWithReuseIdentifier: "CustomButtonCell")
    }
    
    // MARK: - CollectionView DataSource
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return 15 // 假设我们有15个Cell
    }
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "CustomButtonCell", for: indexPath) as! CustomButtonCell
        
        // 根据全局状态配置Cell
        let isSelected = indexPath == selectedCellIndexPath
        cell.setup(with: isSelected)
        
        // 设置按钮点击的闭包
        cell.buttonTapHandler = { [weak self] in
            guard let self = self else { return }
            // 更新全局状态：标记当前点击的Cell为选中
            self.selectedCellIndexPath = indexPath
            // 刷新所有Cell（如果数据量小，直接reloadData最省心）
            self.collectionView.reloadData()
            
            // 如果追求性能，也可以只刷新可见Cell：
            // self.collectionView.visibleCells.forEach { visibleCell in
            //     guard let customCell = visibleCell as? CustomButtonCell,
            //           let cellIndexPath = self.collectionView.indexPath(for: customCell) else { return }
            //     customCell.setup(with: cellIndexPath == self.selectedCellIndexPath)
            // }
        }
        
        return cell
    }
    
    // MARK: - CollectionView Layout（可选，设置Cell大小）
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
        return CGSize(width: collectionView.bounds.width - 32, height: 60)
    }
}

三、其他场景适配 #

如果你的需求是点击按钮后所有按钮都改成同一个颜色（而不是区分选中和未选中），只需要修改全局状态为一个颜色变量：

// 全局状态：统一的按钮背景色
private var targetButtonColor: UIColor = .systemGray

// 点击按钮时更新颜色
cell.buttonTapHandler = { [weak self] in
    guard let self = self else { return }
    self.targetButtonColor = .systemRed // 改成你想要的颜色
    self.collectionView.reloadData()
}

// Cell配置方法改成直接用这个颜色
func setup(with color: UIColor) {
    actionButton.backgroundColor = color
}

四、关键注意事项 #

• 避免循环引用：在闭包中一定要用[weak self]，防止ViewController无法被释放；
• 依赖状态而非直接修改UI：永远不要直接修改Cell的UI而不更新状态，否则Cell复用时会出现样式错乱；
• 性能优化：如果CollectionView的Cell数量很多，优先用“刷新可见Cell”的方式，比全量reload更高效。

内容的提问来源于stack exchange，提问作者H.Epstein