如何在退出全屏图片视图后更新UICollectionView的聚焦索引路径？

问题原因 #

你之前的方案无效的核心原因如下：

• UIKit 自带的转场焦点恢复逻辑（restoresFocusAfterTransition）和集合视图记忆最后焦点逻辑（remembersLastFocusedIndexPath）优先级高于手动对 cell 做的焦点调整，会覆盖你的自定义操作
• 不可见的 cell 无法成为焦点容器，必须先保证目标索引路径对应的 cell 处于可视区域
• 焦点系统和第一响应者是两套独立逻辑，调用becomeFirstResponder()对焦点系统无效

实现步骤 #

1. 调整基础配置 #

关闭系统自动恢复焦点的逻辑，避免覆盖自定义设置：

collectionView.allowsFocus = true
collectionView.allowsFocusDuringEditing = true
// 关闭系统自动记忆最后焦点，改为手动指定
collectionView.remembersLastFocusedIndexPath = false
// 关闭转场后自动恢复之前的焦点
restoresFocusAfterTransition = false

2. 新增目标焦点属性并重写焦点优先级配置 #

在你的 UICollectionViewController 子类中新增目标焦点索引路径属性，重写 preferredFocusEnvironments 告诉焦点系统优先聚焦的容器：

// 存储退出全屏后需要聚焦的目标索引路径
private var targetFocusIndexPath: IndexPath?

override var preferredFocusEnvironments: [UIFocusEnvironment] {
    // 存在目标索引路径且对应cell可见时，优先返回该cell
    if let targetPath = targetFocusIndexPath,
       let targetCell = collectionView.cellForItem(at: targetPath) {
        return [targetCell]
    }
    // 无自定义目标时返回默认逻辑
    return super.preferredFocusEnvironments
}

3. 退出全屏时触发焦点更新 #

在全屏视图控制器退出的完成回调中，传入当前浏览的照片对应的缩略图索引路径，触发焦点更新：

// 此处的currentBrowsePath是全屏模式下当前正在浏览的照片对应的collectionView缩略图索引路径
func handleFullScreenDismiss(currentBrowsePath: IndexPath) {
    // 赋值目标焦点路径
    targetFocusIndexPath = currentBrowsePath
    // 先将目标cell滚动到可视区域，不可见的cell无法被聚焦
    collectionView.scrollToItem(at: currentBrowsePath, at: .centeredVertically, animated: false)
    
    // 等待视图更新完成后触发焦点刷新
    DispatchQueue.main.async { [weak self] in
        guard let self = self else { return }
        self.setNeedsFocusUpdate()
        self.updateFocusIfNeeded()
        // 重置目标路径，避免后续正常操作的焦点逻辑受影响
        self.targetFocusIndexPath = nil
    }
}

注意事项 #

• 如果使用自定义转场动画，需要保证转场完全结束、缩略图控制器已经回到视图层级后再调用上述更新逻辑，否则会出现 cell 未加载导致无法聚焦的问题
• 如果目标 cell 存在复用逻辑，不需要额外处理复用状态，只要 cell 处于可视区域就可以正常获取焦点

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