CoordinatorLayout搭配WRAP_CONTENT滚动子View与CollapsingToolbarLayout适配问题

我之前也碰到过完全一样的场景，折腾了好一阵才摸出可行的解决办法，给你分享几个实用方案：

方案一：自定义ViewPager Behavior，动态控制AppBar折叠程度 #

这是最精准的解决方案，核心思路是监听ViewPager的实际内容高度，对比屏幕可用高度，动态调整AppBarLayout的折叠状态，避免过度折叠导致下方空白。

1. 先实现一个自定义的ViewPagerBehavior，继承自系统的AppBarLayout.ScrollingViewBehavior：

class CustomViewPagerBehavior : AppBarLayout.ScrollingViewBehavior() {
    override fun onDependentViewChanged(parent: CoordinatorLayout, child: View, dependency: View): Boolean {
        val superResult = super.onDependentViewChanged(parent, child, dependency)
        if (dependency is AppBarLayout) {
            val appBar = dependency
            // 获取屏幕可用高度（扣除状态栏、导航栏）
            val availableScreenHeight = parent.height - parent.systemWindowInsetTop - parent.systemWindowInsetBottom
            // 获取当前ViewPager页面的实际内容高度
            val currentPage = (child as ViewPager).getChildAt(child.currentItem)
            val pageContentHeight = currentPage.height

            if (pageContentHeight < availableScreenHeight) {
                // 计算需要保留的AppBar高度，让整体刚好填满屏幕
                val requiredAppBarHeight = availableScreenHeight - pageContentHeight
                val appBarMinHeight = appBar.minHeight

                if (requiredAppBarHeight > appBarMinHeight) {
                    // 计算AppBar需要保持的展开偏移量
                    val offset = appBar.totalScrollRange - (requiredAppBarHeight - appBarMinHeight)
                    appBar.setExpanded(offset > 0, true)
                } else {
                    // 内容高度足够支撑到AppBar最小高度，正常折叠
                    appBar.setExpanded(false, true)
                }
            } else {
                // ViewPager内容足够长，允许AppBar自由折叠/展开
                appBar.setExpanded(appBar.top < 0, true)
            }
        }
        return superResult
    }
}

2. 在布局文件中给ViewPager绑定这个自定义Behavior：

<ViewPager
    android:id="@+id/viewPager"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:layout_behavior=".CustomViewPagerBehavior" />

⚠️ 注意：要提前给AppBarLayout设置android:minHeight，值等于TabLayout的高度，确保AppBar折叠后的最小高度固定。

方案二：给ViewPager设置最小高度，强制填充剩余空间 #

如果不想写自定义Behavior，这个简单粗暴的方法也能解决问题：动态计算屏幕剩余高度，给ViewPager设置最小高度，让它即使内容不足也能撑满空间，避免AppBar过度折叠。

1. 在Activity/Fragment中动态设置ViewPager的最小高度：

val viewPager = findViewById<ViewPager>(R.id.viewPager)
val appBar = findViewById<AppBarLayout>(R.id.appBarLayout)

// 获取屏幕可用高度
val displayMetrics = resources.displayMetrics
val availableHeight = displayMetrics.heightPixels - getStatusBarHeight() - getNavigationBarHeight()

// 设置ViewPager最小高度为可用高度减去AppBar的最小高度
viewPager.minimumHeight = availableHeight - appBar.minHeight

2. 辅助方法获取状态栏和导航栏高度：

private fun getStatusBarHeight(): Int {
    var height = 0
    val resId = resources.getIdentifier("status_bar_height", "dimen", "android")
    if (resId > 0) {
        height = resources.getDimensionPixelSize(resId)
    }
    return height
}

private fun getNavigationBarHeight(): Int {
    var height = 0
    val resId = resources.getIdentifier("navigation_bar_height", "dimen", "android")
    if (resId > 0) {
        height = resources.getDimensionPixelSize(resId)
    }
    return height
}

这个方案的优点是代码量少，缺点是如果ViewPager内容实际高度超过设置的最小高度，会正常滚动，但内容过少时ViewPager会被强行撑高。

方案三：调整CollapsingToolbarLayout的scrollFlags（备选） #

如果你不需要AppBar完全折叠的效果，可以修改CollapsingToolbarLayout的滚动标志，比如换成scroll|snap，这样AppBar会在滚动时停留在展开或折叠状态，不会完全消失：

<CollapsingToolbarLayout
    ...
    app:layout_scrollFlags="scroll|snap">

不过这个方案灵活性差，只适合不需要完全折叠的场景。

额外注意事项 #

• 确保ViewPager的子Fragment布局根节点是wrap_content，这样才能正确获取内容高度；
• 如果使用ViewPager2，需要调整获取当前页面的方式（比如通过适配器获取Fragment后再获取其布局高度）；
• 记得测试不同屏幕尺寸和横竖屏切换的情况，避免适配问题。

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