如何让NestedScrollView的头部随向上滚动即时显示？

默认情况下，AppBarLayout配合NestedScrollView的滚动行为（比如exitUntilCollapsed）会让头部只有在滚动到一定程度后才开始展开，要实现向上滚动多少就同步显示多少头部，核心是自定义AppBarLayout.Behavior来控制滚动偏移逻辑。

步骤1：自定义AppBarLayout Behavior #

重写onNestedScroll方法，让AppBar的偏移量直接跟随NestedScrollView的滚动量，实时调整头部显示幅度：

class CustomAppBarBehavior : AppBarLayout.Behavior() {
    override fun onNestedScroll(
        coordinatorLayout: CoordinatorLayout,
        child: AppBarLayout,
        target: View,
        dxConsumed: Int,
        dyConsumed: Int,
        dxUnconsumed: Int,
        dyUnconsumed: Int,
        type: Int,
        consumed: IntArray
    ) {
        super.onNestedScroll(coordinatorLayout, child, target, dxConsumed, dyConsumed, dxUnconsumed, dyUnconsumed, type, consumed)
        
        // 获取AppBar可滚动的总范围
        val scrollRange = child.totalScrollRange
        // 当前AppBar的顶部偏移量
        val currentOffset = child.top
        // 根据向上滚动量计算新的偏移（dyConsumed为正表示向上滚动）
        val newOffset = currentOffset + dyConsumed
        // 限制偏移在合理范围：0（完全展开）到 -scrollRange（完全收起）
        val clampedOffset = newOffset.coerceIn(-scrollRange, 0)
        
        // 应用偏移量，实时调整头部显示
        child.offsetTopAndBottom(clampedOffset - currentOffset)
    }

    override fun onStartNestedScroll(
        coordinatorLayout: CoordinatorLayout,
        child: AppBarLayout,
        directTargetChild: View,
        target: View,
        axes: Int,
        type: Int
    ): Boolean {
        // 仅响应垂直滚动事件
        return axes and ViewCompat.SCROLL_AXIS_VERTICAL != 0
    }
}

步骤2：在布局中应用自定义Behavior #

在你的布局文件里，给AppBarLayout指定这个自定义Behavior：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.appbar.AppBarLayout
        android:id="@+id/appBar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        <!-- 替换成你的自定义Behavior全类名 -->
        app:layout_behavior="com.your.package.name.CustomAppBarBehavior">

        <!-- 你的头部内容，比如Toolbar、CollapsingToolbarLayout等 -->
        <com.google.android.material.appbar.CollapsingToolbarLayout
            android:layout_width="match_parent"
            android:layout_height="200dp"
            app:layout_scrollFlags="scroll|enterAlways">

            <androidx.appcompat.widget.Toolbar
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                app:layout_collapseMode="pin"/>

        </com.google.android.material.appbar.CollapsingToolbarLayout>

    </com.google.android.material.appbar.AppBarLayout>

    <androidx.core.widget.NestedScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior">

        <!-- 滚动内容区域 -->
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical">

            <!-- 你的子视图 -->

        </LinearLayout>

    </androidx.core.widget.NestedScrollView>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

关键注意点 #

• 确保CollapsingToolbarLayout的scrollFlags包含scroll，这样才能触发滚动联动
• 自定义Behavior中的coerceIn方法是为了避免AppBar偏移超出合理范围，防止出现UI异常
• 如果不需要CollapsingToolbarLayout，直接在AppBarLayout下放置头部视图也能生效

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