基于Android实现滚动头部悬停效果

/* 
 * =====================================================================
 * 文件名称：MainActivity.java
 * 项目名称：StickyHeaderDemo
 * 创建日期：2025-04-14
 * 作者：Katie
 * 描述：本文件演示了如何在 Android 中实现滚动头部悬停效果。
 *       采用 FrameLayout 作为根布局，其中包含固定的头部 View 和
 *       一个 NestedScrollView 作为滚动内容区域。通过监听滚动事件，
 *       实现头部始终悬停在屏幕顶部的效果。详细注释帮助读者理解代码。
 * =====================================================================
 */
 
package com.example.stickyheaderdemo;
 
import android.os.Bundle;
import android.widget.ScrollView;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.widget.NestedScrollView;
import android.view.View;
import android.util.Log;
 
public class MainActivity extends AppCompatActivity {
 
    // 定义日志标签
    private static final String TAG = "StickyHeader";
 
    // 声明头部 View 和滚动视图
    private TextView tvHeader;
    private NestedScrollView scrollView;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 加载布局文件 activity_main.xml
        setContentView(R.layout.activity_main);
 
        // 初始化视图对象
        tvHeader = findViewById(R.id.tv_header);
        scrollView = findViewById(R.id.nested_scroll_view);
 
        // 添加滚动监听，实现对滚动位置的监测（这里可以扩展响应逻辑）
        scrollView.setOnScrollChangeListener(new NestedScrollView.OnScrollChangeListener() {
            /**
             * 当 NestedScrollView 滚动时回调此方法
             * @param v 当前滚动视图
             * @param scrollX 当前水平滚动位置
             * @param scrollY 当前垂直滚动位置
             * @param oldScrollX 之前的水平滚动位置
             * @param oldScrollY 之前的垂直滚动位置
             */
            @Override
            public void onScrollChange(@NonNull NestedScrollView v, int scrollX, int scrollY, int oldScrollX, int oldScrollY) {
                // 输出日志查看当前滚动位置
                Log.d(TAG, "scrollY: " + scrollY);
                /*
                 * 在此处可以添加更多逻辑，比如根据滚动距离改变头部样式或透明度，
                 * 但在本示例中我们的头部 View始终固定在上方，不随内容滚动。
                 */
            }
        });
 
        // 初始化滚动内容，加载模拟数据
        initContent();
    }
 
    /**
     * 方法名称：initContent
     * 功能描述：模拟加载大量内容到滚动区域，便于演示滚动头部悬停效果
     */
    private void initContent() {
        // 找到内容 TextView，并构造长文本
        TextView tvContent = findViewById(R.id.tv_content);
        StringBuilder content = new StringBuilder();
        for (int i = 1; i <= 50; i++) {
            content.append("第 ").append(i).append(" 行数据：这是一段用于测试的示例内容，展示滚动时效果。\n");
        }
        tvContent.setText(content.toString());
    }
}

<!--
    =====================================================================
    文件名称：activity_main.xml
    项目名称：StickyHeaderDemo
    创建日期：2025-04-14
    作者：Katie
    描述：本布局文件采用 FrameLayout 作为根布局，包含一个头部悬停区域和一个
    NestedScrollView 用于放置滚动内容。头部区域始终固定在屏幕顶部，而内容区域可滚动。
    =====================================================================
-->
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/frame_root"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
    <!-- 固定头部区域 -->
    <TextView
        android:id="@+id/tv_header"
        android:layout_width="match_parent"
        android:layout_height="60dp"
        android:background="#FF9800"
        android:text="我是悬停头部（Sticky Header）"
        android:textColor="#FFFFFF"
        android:textSize="18sp"
        android:gravity="center"
        android:elevation="4dp"
        android:layout_gravity="top" />
 
    <!-- 滚动内容区域，内含长文本以便演示滚动效果 -->
    <androidx.core.widget.NestedScrollView
        android:id="@+id/nested_scroll_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginTop="60dp">
        <!-- 内容容器，采用 LinearLayout 垂直排列 -->
        <LinearLayout
            android:id="@+id/content_layout"
            android:orientation="vertical"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:padding="16dp">
 
            <!-- 示例文本区域，加载动态长文本 -->
            <TextView
                android:id="@+id/tv_content"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="滚动内容加载中..."
                android:textSize="16sp"
                android:textColor="#333333" />
        </LinearLayout>
    </androidx.core.widget.NestedScrollView>
 
</FrameLayout>