RecyclerView在Fragment转场过程中未正常过渡的原因排查

嘿，这个问题我之前也踩过坑，核心原因大多和RecyclerView的动态子视图加载机制以及Fragment转场的时机有关，咱们一步步拆解：

为什么RecyclerView没参与转场？ #

主要有这几个关键点：

• 子视图生成时机晚于转场初始化：Fragment的setEnterTransition/setExitTransition是在onCreateView之后、onStart之前就开始计算转场场景（Scene）里的视图了，但RecyclerView的子项是通过Adapter在后续（比如onStart甚至更晚）才绑定创建的，这时候转场已经在准备了，自然没把这些动态生成的子视图算进去。
• 共享元素转场缺少唯一标识：如果你用的是共享元素转场，RecyclerView的子项如果没设置唯一的transitionName，或者转场时没手动指定这些子视图作为共享元素，系统就没法追踪它们的转场状态。
• 默认转场的范围限制：普通的fade、slide等系统默认转场，只会作用于Fragment根布局下初始存在的视图，RecyclerView作为容器，它的子视图属于动态添加的，不在初始的转场视图集合里。

怎么解决？ #

给你几个实用的方案，按需选择：

方案1：延迟转场，等RecyclerView加载完成再启动 #

通过延迟转场时机，让RecyclerView的子视图完全绘制好之后再触发转场，这是最常用的办法：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 先推迟转场
    postponeEnterTransition()
    // 监听RecyclerView的预绘制事件，完成后启动转场
    recyclerView.viewTreeObserver.addOnPreDrawListener(object : ViewTreeObserver.OnPreDrawListener {
        override fun onPreDraw(): Boolean {
            recyclerView.viewTreeObserver.removeOnPreDrawListener(this)
            startPostponedEnterTransition()
            return true
        }
    })
}

如果是退出转场，你也可以在触发转场的地方，等RecyclerView布局完成后再执行。

方案2：为子视图设置共享元素标识并手动传递 #

如果是共享元素转场，需要给每个子项设置唯一的transitionName，并在转场时把这些视图传递给系统：
首先在Adapter的onBindViewHolder里设置标识：

override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
    val item = items[position]
    // 给每个子项设置唯一的transitionName，比如用item的ID或者位置
    holder.itemView.transitionName = "recycler_item_${item.id}"
    // 其他绑定逻辑...
}

然后在启动转场时，收集需要共享的子视图并传递：

// 假设是从当前Fragment跳转到目标Fragment
val targetFragment = TargetFragment()
val extras = FragmentNavigator.Extras.Builder()
// 遍历可见的子视图，添加到共享元素集合
for (i in 0 until recyclerView.childCount) {
    val childView = recyclerView.getChildAt(i)
    val transitionName = childView.transitionName
    extras.addSharedElement(childView, transitionName)
}
// 用extras启动转场
parentFragmentManager.beginTransaction()
    .replace(R.id.container, targetFragment)
    .setReorderingAllowed(true)
    .addSharedElement(recyclerView, "recycler_root") // 可选：如果RecyclerView本身也要共享
    .addExtras(extras.build())
    .commit()

方案3：自定义转场动画，主动包含RecyclerView子视图 #

如果默认转场满足不了需求，可以自定义Transition类，主动遍历RecyclerView的子视图并为它们添加动画：

class RecyclerViewFadeTransition : Transition() {
    override fun captureStartValues(sceneValues: TransitionValues) {
        super.captureStartValues(sceneValues)
        val view = sceneValues.view
        if (view is RecyclerView) {
            // 收集当前可见的子视图
            val childViews = mutableListOf<View>()
            for (i in 0 until view.childCount) {
                childViews.add(view.getChildAt(i))
            }
            sceneValues.values["recycler_children"] = childViews
        }
    }

    override fun createAnimator(sceneRoot: ViewGroup, startValues: TransitionValues?, endValues: TransitionValues?): Animator? {
        val startChildren = startValues?.values?.get("recycler_children") as? List<View>
        val animatorSet = AnimatorSet()
        startChildren?.forEach { childView ->
            // 给每个子视图添加淡入动画
            val fadeAnim = ObjectAnimator.ofFloat(childView, View.ALPHA, 0f, 1f)
            fadeAnim.duration = 300
            animatorSet.play(fadeAnim)
        }
        return animatorSet
    }
}

然后在Fragment里设置这个自定义转场：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    exitTransition = RecyclerViewFadeTransition()
    enterTransition = RecyclerViewFadeTransition()
}

另外补充一点：如果用的是StaggeredGridLayoutManager这类可能异步布局的管理器，记得确保布局完全完成后再启动转场，不然还是会有部分子视图没被捕获到。

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