您的位置:

Android SpannableString详解

一、SpannableString概述

SpannableString是Android中的一个类,用于处理富文本。在一个TextView中,我们可以设置不同的样式、颜色、大小、下划线、点击事件等等。SpannableString可以帮助我们轻松实现这些富文本效果。这个类不仅可以应用于TextView,还可以应用于EditText。

二、SpannableString使用

1. 创建SpannableString对象

创建SpannableString对象很简单,只需要提供一个字符串,就可以得到一个没有任何格式的SpannableString对象。

SpannableString spannableString = new SpannableString("这是一个SpannableString对象");

2. 设置文本样式

将一段文字设置为加粗或 italic 样式可以通过StyleSpan来实现。下划线可以通过UnderlineSpan来实现,删除线可以通过StrikethroughSpan来实现。

// 加粗样式
StyleSpan boldSpan = new StyleSpan(Typeface.BOLD);
spannableString.setSpan(boldSpan, 2, 4, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

// italic样式
StyleSpan italicSpan = new StyleSpan(Typeface.ITALIC);
spannableString.setSpan(italicSpan, 6, 8, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

// 下划线
UnderlineSpan underlineSpan = new UnderlineSpan();
spannableString.setSpan(underlineSpan, 10, 12, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

// 删除线
StrikethroughSpan strikethroughSpan = new StrikethroughSpan();
spannableString.setSpan(strikethroughSpan, 14, 16, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

3. 设置文本颜色

通过ForegroundColorSpan可以为文本设置颜色。

ForegroundColorSpan colorSpan = new ForegroundColorSpan(Color.RED);
spannableString.setSpan(colorSpan, 18, 20, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

4. 设置文本大小

通过RelativeSizeSpan可以为文本设置相对大小。

RelativeSizeSpan sizeSpan = new RelativeSizeSpan(1.5f);
spannableString.setSpan(sizeSpan, 22, 24, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

5. 设置文本超链接

通过URLSpan可以为文本设置超链接,当用户点击这段文本时,会打开一个指定的URL地址。

String url = "https://www.google.com";
URLSpan urlSpan = new URLSpan(url);
spannableString.setSpan(urlSpan, 26, 28, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

6. 设置文本点击事件

通过ClickableSpan可以为文本设置点击事件,当用户点击这段文本时,会调用指定的click方法。

ClickableSpan clickableSpan = new ClickableSpan() {
    @Override
    public void onClick(View widget) {
        Toast.makeText(MainActivity.this, "点击了文本", Toast.LENGTH_SHORT).show();
    }
};
spannableString.setSpan(clickableSpan, 30, 32, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
textView.setMovementMethod(LinkMovementMethod.getInstance());
textView.setText(spannableString);

三、SpannableStringBuilder使用

SpannableStringBuilder类和StringBuilder类很像,它也是用于构建字符串的,但它可以为添加的字符串设置样式。可以将多个SpannableString对象拼接在一起。

SpannableStringBuilder builder = new SpannableStringBuilder();
String text1 = "这是第一段文字 ";
String text2 = "这是第二段文字 ";
String text3 = "这是第三段文字 ";

SpannableString spannableString1 = new SpannableString(text1);
SpannableString spannableString2 = new SpannableString(text2);
SpannableString spannableString3 = new SpannableString(text3);

ForegroundColorSpan colorSpan = new ForegroundColorSpan(Color.RED);
spannableString1.setSpan(colorSpan, 2, 4, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

StyleSpan italicSpan = new StyleSpan(Typeface.ITALIC);
spannableString2.setSpan(italicSpan, 6, 8, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

builder.append(spannableString1);
builder.append(spannableString2);
builder.append(spannableString3);

textView.setText(builder);

四、Spanned接口和可扩展的Span

SpannableString实现了Spanned接口。Spanned接口定义了一个方法getSpans,它可以返回指定范围内的所有Span对象。这个方法可以被用于删除指定范围内的Span对象。

BackgroundColorSpan backgroundColorSpan = new BackgroundColorSpan(Color.YELLOW);
spannableString.setSpan(backgroundColorSpan, 0, 4, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

ForegroundColorSpan foregroundColorSpan = new ForegroundColorSpan(Color.BLUE);
spannableString.setSpan(foregroundColorSpan, 2, 6, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

Object[] spans = ((Spanned) spannableString).getSpans(1, 4, Object.class);

for (Object object : spans) {
    spannableString.removeSpan(object);
}

textView.setText(spannableString);
如果Spanned接口中没有定义的Span,可以自定义一个Span。
public class MySpan extends CharacterStyle {
    @Override
    public void updateDrawState(@NonNull TextPaint paint) {
        paint.setColor(Color.GREEN);
        paint.setTextSize(60);
    }
}

MySpan mySpan = new MySpan();
spannableString.setSpan(mySpan, 2, 6, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

五、总结

SpannableString是Android提供的一个非常强大的类,可以非常简单地实现富文本效果。通过掌握SpannableString的使用方法,我们可以轻松地给用户带来更好的阅读体验。