SpannableStringBuilder: Android文本樣式處理工具

SpannableStringBuilder提供了一種強大的方法來處理Android應用程序中的文本樣式。該類是其父類 SpannableString 的拓展，允許您在一段文本中創造更複雜的樣式而不必創建多個文本。本文將從多個角度為大家詳細闡述SpannableStringBuilder，介紹其功能和用法。

一、創建SpannableStringBuilder實例

在介紹SpannableStringBuilder的具體使用方法之前，先來看一下如何創建SpannableStringBuilder的實例，示例代碼如下：

SpannableStringBuilder builder = new SpannableStringBuilder("Hello World!");

以上代碼創建了一個包含文本”Hello World!”的SpannableStringBuilder實例。在該文本上可以應用 Span，這些 Span 可以用於設置文本的格式。

二、設置文本顏色

在 Android 中，設置文本顏色是常見的格式化操作。SpannableStringBuilder 的 setSpan() 方法使得它很方便進行這一操作。下面我們來看一下如何設置文本顏色，示例代碼如下：

builder.setSpan(new ForegroundColorSpan(Color.RED), 0, 5, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

以上代碼設置了 “Hello” 為紅色。ForegroundColorSpan 表示前景色（即文本顏色），其構造函數可以傳入顏色值。setSpan() 方法接受參數如下：

• 第一個參數： Span ，本例為 ForegroundColorSpan
• 第二個參數：起始位置（0）
• 第三個參數：終止位置（5）
• 第四個參數：標誌、在本例中，跨度將僅應用於第一個範圍

通過 SpannableStringBuilder 和 Span 介面，可以對文本進行更多樣式上的設置。

三、設置文本字體大小

可以使用 AbsoluteSizeSpan 類來更改文本的字體大小，示例代碼如下：

builder.setSpan(new AbsoluteSizeSpan(20), 6, 11, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

以上代碼將 “World” 的字體大小設置為20dp。AbsoluteSizeSpan 構造函數的第一個參數是字體大小，單位為像素，第二個參數是該範圍的起始位置，第三個參數是終止位置，第四個參數是標誌。

四、設置文本樣式

在 Android 中，設置文本樣式是很常見的操作之一。可以使用 StyleSpan 類來指定樣式，這個類可以接受 Typeface.BOLD，Typeface.ITALIC，Typeface.BOLD_ITALIC 或 Typeface.NORMAL 整數值作為構造函數的參數。示例代碼如下：

builder.setSpan(new StyleSpan(Typeface.BOLD), 0, 5, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

以上代碼將 “Hello” 設置為粗體。StyleSpan 構造函數的參數指定粗體是 Typeface.BOLD，斜體是 Typeface.ITALIC。

五、結合多個Span操作

可以在同一個文本範圍內應用多個Span進行操作。例如下面的代碼將 “Hello World!” 中的 “W” 分別標記為粗體和斜體：

builder.setSpan(new StyleSpan(Typeface.BOLD), 6, 7, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
builder.setSpan(new StyleSpan(Typeface.ITALIC), 6, 7, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

以上代碼將 “World” 的字體大小設置為20dp。AbsoluteSizeSpan 構造函數的第一個參數是字體大小，單位為像素，第二個參數是該範圍的起始位置，第三個參數是終止位置，第四個參數是標誌。

六、自定義Span

在處理文本時，有時需要更大的靈活性以操作文本。例如，您可以完全自定義Span，以實現不同的樣式。自定義Span的步驟如下：

1. 創建您的Span對象
2. 使用 SpannableStringBuilder 類的 setSpan() 方法應用Span

以下是一個CustomSpan的例子，用於給 text 中的第一個單詞添加一個自定義的樣式，示例代碼如下：

private class CustomSpan extends MetricAffectingSpan {
    @Override
    public void updateDrawState(TextPaint paint) {
        // 可以自定義樣式，例如文本顏色、字體大小、字體等等
        paint.setColor(Color.GREEN);
    }

    @Override
    public void updateMeasureState(TextPaint paint) {
        paint.setColor(Color.BLUE);
    }
}

CustomSpan customSpan = new CustomSpan();
builder.setSpan(customSpan, 0, builder.length(), Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

創建一個 Custom Span ，並覆蓋 updateDrawState() 和 updateMeasureState() 方法，其中 updateDrawState() 方法將應用於繪製文本時的樣式，updateMeasureState() 方法將影響文本測量時的值。在示例代碼中，製作一個文本顏色為綠色的CustomSpan。

總結

SpannableStringBuilder 相比使用多個TextView對象顯然更高效、方便。通過使用Span，我們可以在單個 TextView 的文本上進行操作，以達到更好的布局和更豐富的文本效果。SpannableStringBuilder 可以實現的效果還有很多，讀者可以在實踐中進一步研究和應用。