/* 
 * =====================================================================
 * 文件名稱(chēng)：MainActivity.java
 * 項(xiàng)目名稱(chēng)：StickyHeaderDemo
 * 創(chuàng)建日期：2025-04-14
 * 作者：Katie
 * 描述：本文件演示了如何在 Android 中實(shí)現(xiàn)滾動(dòng)頭部懸停效果。
 *       采用 FrameLayout 作為根布局，其中包含固定的頭部 View 和
 *       一個(gè) NestedScrollView 作為滾動(dòng)內(nèi)容區(qū)域。通過(guò)監(jiān)聽(tīng)滾動(dòng)事件，
 *       實(shí)現(xiàn)頭部始終懸停在屏幕頂部的效果。詳細(xì)注釋幫助讀者理解代碼。
 * =====================================================================
 */
 
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 {
 
    // 定義日志標(biāo)簽
    private static final String TAG = "StickyHeader";
 
    // 聲明頭部 View 和滾動(dòng)視圖
    private TextView tvHeader;
    private NestedScrollView scrollView;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 加載布局文件 activity_main.xml
        setContentView(R.layout.activity_main);
 
        // 初始化視圖對(duì)象
        tvHeader = findViewById(R.id.tv_header);
        scrollView = findViewById(R.id.nested_scroll_view);
 
        // 添加滾動(dòng)監(jiān)聽(tīng)，實(shí)現(xiàn)對(duì)滾動(dòng)位置的監(jiān)測(cè)（這里可以擴(kuò)展響應(yīng)邏輯）
        scrollView.setOnScrollChangeListener(new NestedScrollView.OnScrollChangeListener() {
            /**
             * 當(dāng) NestedScrollView 滾動(dòng)時(shí)回調(diào)此方法
             * @param v 當(dāng)前滾動(dòng)視圖
             * @param scrollX 當(dāng)前水平滾動(dòng)位置
             * @param scrollY 當(dāng)前垂直滾動(dòng)位置
             * @param oldScrollX 之前的水平滾動(dòng)位置
             * @param oldScrollY 之前的垂直滾動(dòng)位置
             */
            @Override
            public void onScrollChange(@NonNull NestedScrollView v, int scrollX, int scrollY, int oldScrollX, int oldScrollY) {
                // 輸出日志查看當(dāng)前滾動(dòng)位置
                Log.d(TAG, "scrollY: " + scrollY);
                /*
                 * 在此處可以添加更多邏輯，比如根據(jù)滾動(dòng)距離改變頭部樣式或透明度，
                 * 但在本示例中我們的頭部 View始終固定在上方，不隨內(nèi)容滾動(dòng)。
                 */
            }
        });
 
        // 初始化滾動(dòng)內(nèi)容，加載模擬數(shù)據(jù)
        initContent();
    }
 
    /**
     * 方法名稱(chēng)：initContent
     * 功能描述：模擬加載大量?jī)?nèi)容到滾動(dòng)區(qū)域，便于演示滾動(dòng)頭部懸停效果
     */
    private void initContent() {
        // 找到內(nèi)容 TextView，并構(gòu)造長(zhǎng)文本
        TextView tvContent = findViewById(R.id.tv_content);
        StringBuilder content = new StringBuilder();
        for (int i = 1; i <= 50; i++) {
            content.append("第 ").append(i).append(" 行數(shù)據(jù)：這是一段用于測(cè)試的示例內(nèi)容，展示滾動(dòng)時(shí)效果。\n");
        }
        tvContent.setText(content.toString());
    }
}

<!--
    =====================================================================
    文件名稱(chēng)：activity_main.xml
    項(xiàng)目名稱(chēng)：StickyHeaderDemo
    創(chuàng)建日期：2025-04-14
    作者：Katie
    描述：本布局文件采用 FrameLayout 作為根布局，包含一個(gè)頭部懸停區(qū)域和一個(gè)
    NestedScrollView 用于放置滾動(dòng)內(nèi)容。頭部區(qū)域始終固定在屏幕頂部，而內(nèi)容區(qū)域可滾動(dòng)。
    =====================================================================
-->
<?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">
 
    <!-- 固定頭部區(qū)域 -->
    <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" />
 
    <!-- 滾動(dòng)內(nèi)容區(qū)域，內(nèi)含長(zhǎng)文本以便演示滾動(dòng)效果 -->
    <androidx.core.widget.NestedScrollView
        android:id="@+id/nested_scroll_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginTop="60dp">
        <!-- 內(nèi)容容器，采用 LinearLayout 垂直排列 -->
        <LinearLayout
            android:id="@+id/content_layout"
            android:orientation="vertical"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:padding="16dp">
 
            <!-- 示例文本區(qū)域，加載動(dòng)態(tài)長(zhǎng)文本 -->
            <TextView
                android:id="@+id/tv_content"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="滾動(dòng)內(nèi)容加載中..."
                android:textSize="16sp"
                android:textColor="#333333" />
        </LinearLayout>
    </androidx.core.widget.NestedScrollView>
 
</FrameLayout>