Android Spannable を使って文字列の一部を装飾する

SpannableStringBuilder を使って、文字列の一部を装飾（bold, italic, typeface, color, size) することができます。

こんな感じ。


public class SpannableSampleActivity extends Activity {

private static StyleSpan sBoldStyleSpan = new StyleSpan(Typeface.BOLD);
private static TypefaceSpan sSerifTypefaceSpan = new TypefaceSpan("serif");

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

TextAppearanceSpan cyanTextAppearanceSpan =
new TextAppearanceSpan(this, R.style.MyTextAppearance);

SpannableStringBuilder sb = new SpannableStringBuilder();
sb.append(getString(R.string.pretext) + " ");

int start = sb.length();
sb.append(getString(R.string.boldtext));
sb.setSpan(sBoldStyleSpan, start, sb.length(),
Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

sb.append(" " + getString(R.string.posttext) + " ");

start = sb.length();
sb.append(getString(R.string.seriftext));
sb.setSpan(sSerifTypefaceSpan, start, sb.length(),
Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

sb.append(" " + getString(R.string.posttext) + " ");

start = sb.length();
sb.append(getString(R.string.cyantext));
sb.setSpan(cyanTextAppearanceSpan, start, sb.length(),
Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

sb.append(" " + getString(R.string.posttext));

((TextView)findViewById(R.id.textview)).setText(sb);
}
}


res/values/styles.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<style name="MyTextAppearance" parent="@android:style/TextAppearance">
<item name="android:textColor">#00ffff</item>
<item name="android:textSize">30sp</item>
<item name="android:textStyle">italic</item>
</style>
</resources>




SpannableStringBuilder には複数の Span が設定可能で、それぞれ setSpan() メソッドで設定できます。

設定されている Span オブジェクトの一覧は getSpans() メソッドで取得でき、特定の Span オブジェクトの設定されている開始位置や終了位置、フラグなどは getSpanStart(), getSpanEnd(), getSpanFlags() で取得できます。 Span を削除する場合は removeSpan() を呼び出します。

SpannalbeStringBuilder の Span 操作

• setSpan()
  
• removeSpan()
  
• getSpans()
  
• getSpanStart()
  
• getSpanEnd()
  
• getSpanFlags()
  

setSpan() の4つ目の引数で、この span の範囲内に文字が挿入されたときにどう振舞うかを指定することができます。指定できるフラグは Spanned に定義されている SPAN_* の定数のうち次の5個です。

• SPAN_INCLUSIVE_EXCLUSIVE
  
• SPAN_INCLUSIVE_INCLUSIVE
  
• SPAN_EXCLUSIVE_EXCLUSIVE
  
• SPAN_EXCLUSIVE_INCLUSIVE
  
• SPAN_PARAGRAPH
  

SpannableStringBuilder の文字列操作

• append()
  
• insert()
  
• replace()

など

Span オブジェクトとして指定できるクラスとしていくつかあります。

• StyleSpan
  bold, italic を指定
  
• TypefaceSpane
  "monospace", "serif", "sans-serif" を指定
  
• TextAppearanceSpan
  文字の色、サイズ、style、typeface を一致する TextAppearance リソースに設定
  
• AbsoluteSizeSpan
  
• RelativeSizeSpan
  
• ReplacementSpan
  
• ScaleXSpan
  
• SubscriptSpan
  
• SuperscriptSpan
  

StyleSpan を使うときの注意点として、このスタイルが累積するものなので、例えば bold と italic 両方を別々の span で設定したり、ベースのスタイルが bold で italic の span を呼び出した場合、 bold italic になります。ベーススタイルからのスタイルはオフにすることができません。

コンストラクタの引数でスタイルを設定します。設定できるスタイルは Typeface クラスで定義されている次の4個です。

• BOLD
  
• BOLD_ITALIC
  
• ITALIC
  
• NORMAL
  

TypefaceSpane のコンストラクタで指定できる family は次の3個です。

• "monospace"
  
• "serif"
  
• "sans-serif"
  

TextAppearanceSpan には、文字の typeface、大きさ、色を引数で指定する

- public TextAppearanceSpan (String family, int style, int size, ColorStateList color, ColorStateList linkColor)

と、TextAppearance のリソース ID を指定する

- public TextAppearanceSpan (Context context, int appearance)

- public TextAppearanceSpan (Context context, int appearance, int colorList)

があります。