UICollectionView创建越界单元格未触发willDisplay回调的解决方案咨询

首先得明确一点：你遇到的willDisplay回调不触发的情况是正常机制——UICollectionView的willDisplay(_:forItemAt:)代理方法只会在单元格即将进入可见区域时才会被调用，那些一开始就处于视图边界外的越界单元格，UICollectionView认为它们不需要被显示给用户，所以不会触发这个回调。

针对你的需求，下面提供几个可行的方案来捕获越界单元格的创建时机：

方案一：子类化UICollectionView监听subview添加 #

单元格被创建后会作为subview添加到UICollectionView上，我们可以通过子类化UICollectionView并重写didAddSubview(_:)方法来捕获这个时机：

class FadingCollectionView: UICollectionView {
    override func didAddSubview(_ subview: UIView) {
        super.didAddSubview(subview)
        
        // 只处理UICollectionViewCell类型的子视图
        guard let cell = subview as? UICollectionViewCell,
              let indexPath = self.indexPath(for: cell),
              let attributes = self.layoutAttributesForItem(at: indexPath) else {
            return
        }
        
        // 判断单元格是否与CollectionView可见区域相交
        let isInVisibleBounds = self.bounds.intersects(attributes.frame)
        if !isInVisibleBounds {
            cell.alpha = 0
        }
    }
}

使用这个自定义CollectionView后，不管是初始加载还是滚动复用的单元格，只要被添加到视图层级中，就能立刻判断是否越界并设置透明度。

方案二：利用布局完成时机批量处理 #

在CollectionView布局完成后，我们可以主动获取所有单元格（包括越界的）并进行判断。适合在viewDidLayoutSubviews或者布局更新后调用：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    
    // 遍历所有已显示的单元格，判断是否越界
    collectionView.visibleCells.forEach { cell in
        guard let indexPath = collectionView.indexPath(for: cell) else { return }
        let attributes = collectionView.layoutAttributesForItem(at: indexPath)!
        if !collectionView.bounds.intersects(attributes.frame) {
            cell.alpha = 0
        }
    }
}

注意：这个方法需要在布局稳定后调用，避免因布局未完成导致frame判断不准确。

补充：复用单元格的重置处理 #

因为单元格会被复用，所以在willDisplay回调里需要把透明度重置为1，确保滚入可见区域的单元格能正常显示（还可以顺便添加淡入动画）：

func collectionView(_ collectionView: UICollectionView, willDisplay cell: UICollectionViewCell, forItemAt indexPath: IndexPath) {
    // 重置透明度并添加淡入动画
    cell.alpha = 0
    UIView.animate(withDuration: 0.3) {
        cell.alpha = 1
    }
}

为什么不推荐依赖dequeueReusableCell的时机？ #

你提到的在调用dequeueReusableCell(withReuseIdentifier:for:)时获知创建，但此时单元格的frame还没有被布局引擎计算出来，无法准确判断是否越界——布局属性是在CollectionView布局阶段才会被赋值的，所以此时的frame是不准确的。

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