实现Table View中所有Collection View同步横向滚动方案求助

核心思路 #

通过监听任意一个CollectionView的滚动事件，同步更新所有其他CollectionView的contentOffset，同时避免循环触发滚动回调。

具体实现步骤 #

1. 维护所有CollectionView的实例引用

在TableView所在的ViewController中，声明数组存储所有cell内的CollectionView，同时处理cell复用带来的重复引用问题：

class ViewController: UIViewController {
    // 存储所有需要同步的CollectionView
    private var collectionViews: [UICollectionView] = []
    // 标记是否正在同步滚动，避免循环触发回调
    private var isSyncingScroll = false
    
    // ...其他代码
}

在TableView的cellForRowAt方法中，将cell内的CollectionView加入数组，并移除旧引用（防止cell复用重复添加）：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "CustomTableCell", for: indexPath) as! CustomTableCell
    
    // 移除已存在的旧引用
    if let index = collectionViews.firstIndex(of: cell.collectionView) {
        collectionViews.remove(at: index)
    }
    // 添加新的CollectionView引用
    collectionViews.append(cell.collectionView)
    // 设置当前CollectionView的代理为ViewController
    cell.collectionView.delegate = self
    
    // 配置cell数据源...
    return cell
}

同时处理cell回收时的引用清理：

func tableView(_ tableView: UITableView, didEndDisplaying cell: UITableViewCell, forRowAt indexPath: IndexPath) {
    guard let customCell = cell as? CustomTableCell else { return }
    if let index = collectionViews.firstIndex(of: customCell.collectionView) {
        collectionViews.remove(at: index)
    }
}

2. 实现滚动同步逻辑

让ViewController遵守UIScrollViewDelegate，实现scrollViewDidScroll方法：

extension ViewController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        guard !isSyncingScroll, let currentCV = scrollView as? UICollectionView else { return }
        
        isSyncingScroll = true
        // 获取当前滚动的偏移量
        let targetOffset = scrollView.contentOffset
        
        // 遍历所有CollectionView，同步偏移量
        for cv in collectionViews {
            if cv !== currentCV {
                cv.contentOffset = targetOffset
            }
        }
        
        isSyncingScroll = false
    }
}

3. 关键注意事项

• 确保所有CollectionView的contentSize完全一致（item数量、宽度统一），否则同步滚动会出现错位。
• 如果CollectionView有自定义布局，需保证布局逻辑在所有cell中完全相同。
• 若使用OC开发，逻辑完全一致，仅语法调整：用NSMutableArray存储实例，在scrollViewDidScroll中遍历设置contentOffset即可。

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