Android 實現局部 TextView 滾動：ScrollView 嵌套佈局最佳實踐

問題本質

在複雜佈局中，僅需讓特定 TextView 垂直滾動，而非整個頁面滾動。直接在 LinearLayout/RelativeLayout 中設置 android:scrollbars="vertical" 無效，必須用 ScrollView 包裹目標 TextView。

標準解決方案

<RelativeLayout
    android:layout_width="250dp"
    android:layout_height="374dp"
    android:layout_marginBottom="6dp"
    android:layout_marginLeft="35dp"
    android:layout_marginTop="20dp"
    android:background="#C71585">

    <!-- 上部固定內容 -->
    <RelativeLayout
        android:id="@+id/linearLayout1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true"
        android:layout_marginTop="25dp"
        android:background="@drawable/add_schedule_bg">
        <!-- 按鈕區域 -->
    </RelativeLayout>

    <ImageView
        android:id="@+id/breakARTISTIMAGE"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_alignParentLeft="true"
        android:layout_below="@id/linearLayout1"
        android:layout_marginTop="14dp"
        android:src="@drawable/ic_launcher"/>

    <!-- 關鍵：ScrollView 包裹需滾動的 TextView -->
    <ScrollView
        android:id="@+id/breakSCROLLVIEW"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_alignParentRight="true"
        android:layout_below="@id/breakARTISTIMAGE"
        android:layout_above="@id/breakARTISTIMAGE2">

        <TextView
            android:id="@+id/breakARTISTDESCRIPTION"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:textAppearance="?android:attr/textAppearanceMedium"
            android:textColor="#FFFFFF"/>
    </ScrollView>

    <ImageView
        android:id="@+id/breakARTISTIMAGE2"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_alignParentRight="true"
        android:layout_above="@id/breakSCROLLVIEW"
        android:src="@drawable/ic_launcher"/>
</RelativeLayout>

關鍵屬性解析

進階優化技巧

1. 文字長度動態判斷是否啟用滾動

textView.post(() -> {
    int lineCount = textView.getLineCount();
    if (lineCount > MAX_VISIBLE_LINES) {
        scrollView.setVerticalScrollBarEnabled(true);
    } else {
        scrollView.setVerticalScrollBarEnabled(false);
    }
});

2. 嵌套滾動衝突解決 (API 21+)

// 父佈局為 RecyclerView/NestedScrollView 時
scrollView.setNestedScrollingEnabled(true);
// 子 TextView 禁止攔截觸摸事件
textView.setOnTouchListener((v, event) -> {
    v.getParent().requestDisallowInterceptTouchEvent(true);
    return false;
});

3. 性能優化：大文本分頁加載

// 超過 5000 字符建議分頁
public class PagedTextView extends TextView {
    private static final int PAGE_SIZE = 3000;
    private List pages = new ArrayList<>();
    private int currentPage = 0;
    
    public void setFullText(String text) {
        // 智能分頁邏輯（保留段落完整性）
        splitIntoPages(text);
        showPage(0);
    }
}

常見坑位避雷

1. ScrollView 嵌套 ScrollView：會導致滾動事件分發混亂，改用 NestedScrollView
2. layout_height="match_parent" 導致 ScrollView 無法滾動：必須用 wrap_content + 約束
3. 文本設置 android:singleLine="true" 會禁用換行滾動
4. 硬件加速導致長文本渲染異常：setLayerType(LAYER_TYPE_SOFTWARE, null)