Android TextView 多樣式文字：Html.fromHtml 與 SpannableString 兩大方案完整比較

需求：在單一 TextView 中顯示**不同字型、顏色、大小、底線**的文字（如標題粗體、內容正常、關鍵字紅色）。Android 提供兩種主流方案：HTML 標籤 與 Spannable。

方案一：Html.fromHtml()（簡單、宣告式、支援有限標籤）

基本用法

String html = "<b>標題</b><br/><small>描述文字</small><br/><font color='#FF0000'>重要提醒</font>";
textView.setText(Html.fromHtml(html, Html.FROM_HTML_MODE_LEGACY)); // API 24+ 需指定模式

支援標籤對照表

超連結可點擊完整範例

String html = "請閱讀 <a href='https://example.com/terms'>服務條款</a> 與 <a href='https://example.com/privacy'>隱私權政策</a>";
Spanned spanned = Html.fromHtml(html, Html.FROM_HTML_MODE_LEGACY);
textView.setText(spanned);
textView.setMovementMethod(LinkMovementMethod.getInstance()); // 關鍵：啟用點擊
textView.setLinkTextColor(Color.BLUE); // 連結顏色

方案二：SpannableString / SpannableStringBuilder（程式化、功能完整、效能佳）

基本建構

SpannableStringBuilder builder = new SpannableStringBuilder();

// 1. 粗體標題
String title = "標題\n";
builder.append(title);
builder.setSpan(new StyleSpan(Typeface.BOLD), 0, title.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);

// 2. 正常描述
String desc = "描述文字\n";
int start = builder.length();
builder.append(desc);
builder.setSpan(new RelativeSizeSpan(0.9f), start, builder.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);

// 3. 紅色關鍵字
String warn = "重要提醒";
start = builder.length();
builder.append(warn);
builder.setSpan(new ForegroundColorSpan(Color.RED), start, builder.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
builder.setSpan(new StyleSpan(Typeface.BOLD), start, builder.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);

textView.setText(builder);

常用 Span 類別

ClickableSpan 完整可點擊範例

String text = "同意 服務條款 與 隱私權政策";
SpannableString spannable = new SpannableString(text);

spannable.setSpan(new ClickableSpan() {
    @Override
    public void onClick(@NonNull View widget) {
        // 開啟條款頁面
    }
    @Override
    public void updateDrawState(@NonNull TextPaint ds) {
        ds.setColor(Color.BLUE);
        ds.setUnderlineText(true);
    }
}, 2, 6, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); // "服務條款" 位置

spannable.setSpan(new ClickableSpan() {
    @Override
    public void onClick(@NonNull View widget) {
        // 開啟隱私權頁面
    }
    @Override
    public void updateDrawState(@NonNull TextPaint ds) {
        ds.setColor(Color.BLUE);
        ds.setUnderlineText(true);
    }
}, 9, 15, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); // "隱私權政策" 位置

textView.setText(spannable);
textView.setMovementMethod(LinkMovementMethod.getInstance()); // 必須設定
textView.setHighlightColor(Color.TRANSPARENT); // 移除點擊高亮

方案選擇建議

效能提示

• HTML 解析有 CPU 開銷，大量列表請**快取 Spanned 結果**或改用 Spannable。
• SpannableString 內容不可變，SpannableStringBuilder 可變，建構時用 Builder，最後可轉 Spanned 快取。
• API 24+ Html.fromHtml 預設行為變更，舊專案務必加 Html.FROM_HTML_MODE_LEGACY 旗標。

靈活運用兩種方案，能以最少程式碼實現豐富的文字排版效果。