[Android][SpannableString]

1.什么是SpannableString

SpannableString其实和String一样,都是一种字符串类型,SpannableString可以直接作为TextView的显示文本,不同的是SpannableString可以通过使用其方法setSpan方法实现字符串各种形式风格的显示,重要的是可以指定设置的区间,也就是为字符串指定下标区间内的子字符串设置格式。

2.主要使用方法

setSpan(Object what, int start, int end, int flags)

方法需要用户输入四个参数,

`what` 表示设置的格式是什么,可以是前景色、背景色也可以是可点击的文本等等。

`start` 表示需要设置格式的子字符串的起始下标。

`end` 表示结束应用指定Span的位置下标,特效并不包括这个位置。比如如果这里数为3(即第4个字符),第4个字符不会有任何特效。

`flags` 属性就有意思了,共有四种属性:

`Spanned.SPAN_INCLUSIVE_EXCLUSIVE` 从起始下标到终了下标,包括起始下标  `Spanned.SPAN_INCLUSIVE_INCLUSIVE` 从起始下标到终了下标,同时包括起始下标和终了下标  `Spanned.SPAN_EXCLUSIVE_EXCLUSIVE` 从起始下标到终了下标,但都不包括起始下标和终了下标  `Spanned.SPAN_EXCLUSIVE_INCLUSIVE` 从起始下标到终了下标,包括终了下标

flags参数标识了当在所标记范围前和标记范围后紧贴着插入新字符时的动作,即是否对新插入的字符应用同样的样式。

SpannableString的setSpan()方法可以同时使用多个,实现多种效果叠加。

3.常用格式

1、BackgroundColorSpan 背景色
2、ClickableSpan 文本可点击,有点击事件
3、ForegroundColorSpan 文本颜色(前景色)
4、MaskFilterSpan 修饰效果,如模糊(BlurMaskFilter)、浮雕(EmbossMaskFilter)
5、MetricAffectingSpan 父类,一般不用
6、RasterizerSpan 光栅效果
7、StrikethroughSpan 删除线(中划线)
8、SuggestionSpan 相当于占位符
9、UnderlineSpan 下划线
10、AbsoluteSizeSpan 绝对大小(文本字体)
11、DynamicDrawableSpan 设置图片,基于文本基线或底部对齐。
12、ImageSpan 图片
13、RelativeSizeSpan 相对大小(文本字体)
14、ReplacementSpan 父类,一般不用
15、ScaleXSpan 基于x轴缩放
16、StyleSpan 字体样式:粗体、斜体等
17、SubscriptSpan 下标(数学公式会用到)
18、SuperscriptSpan 上标(数学公式会用到)
19、TextAppearanceSpan 文本外貌(包括字体、大小、样式和颜色)
20、TypefaceSpan 文本字体
21、URLSpan 文本超链接

4.SpannaleStringBuilder

String有StringBuilder,作用就是拼接字符串,其实SpannableString 也可以拼接字符串,SpannableStringBuilder。

5.例子解析

1)BackgroundColorSpan

/**
 * 设置字体背景颜色
 */
private void testBackgroundColorSpan()
{
    SpannableString ss = new SpannableString(text1+text2+text3);
    ss.setSpan(new BackgroundColorSpan(Color.GREEN),0,text1.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    textView.setText(ss);
}

2)ClickableSpan

/**
 * 文本可点击,有点击事件
 */
private void testClickableSpan()
{
    SpannableString ss = new SpannableString(text1+text2+text3);
    ss.setSpan(new BackgroundColorSpan(Color.GREEN),3,5, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    ss.setSpan(new ClickableSpan() {
        @Override
        public void onClick(View widget) {
            Toast.makeText(TestSpanableStringActvity.this,text2,Toast.LENGTH_SHORT).show();
        }
    }, text1.length() - 1, text1.length() + text2.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    textView.setText(ss);
    //要实现点击时间必须要调用这个方法
    textView.setMovementMethod(LinkMovementMethod.getInstance());
}

如果要实现点击事件,必须要实现

textView.setMovementMethod(LinkMovementMethod.getInstance());

而且我们可以看到,上面我们调用了两个格式,一个是设置背景颜色的BackgroundColorSpan,一个是ClickableSpan,这里验证了上面所说的setSpan()方法可以同时使用多个,实现多种效果叠加。

3)ForegroundColorSpan

/**
 * 设置字体颜色
 */
private void testForegroundColorSpan ()
{
    SpannableString ss = new SpannableString(text1+text2+text3);
    ss.setSpan(new ForegroundColorSpan(Color.RED),3,6, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    textView.setText(ss);
}

4)测试setSpan第四个参数的作用

    String text1 = "早上好";
    String text2 = "下午好";
    String text3 = "今晚吃什么?";
    /**
     * 测试setSpan第四个参数的作用
     */
    private void testSpanFlag ()
    {
        SpannableString ss = new SpannableString(text1+text2+text3);
        ss.setSpan(new ForegroundColorSpan(Color.RED),3,6, Spannable.SPAN_INCLUSIVE_INCLUSIVE);
//        ss.setSpan(new ForegroundColorSpan(Color.RED),3,6, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
//        ss.setSpan(new ForegroundColorSpan(Color.RED),3,6, Spannable.SPAN_EXCLUSIVE_INCLUSIVE);
//        ss.setSpan(new ForegroundColorSpan(Color.RED),3,6, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
        textView.setText(ss);
    }

经过测试,如果如上设置的话,上面四个flag的效果是一样的,根本达不到这四个flag所表达意思的效果,
而且,我们也可以看到,setSpan的作用区域默认是包含起始坐标的字符,不包含结束坐标的字符。
那么这个flag到底怎么用?
查了资料才知道,这个flag参数视乎只对插入的字符产生作用。

/**
 * 测试setSpan第四个参数的作用例子2
 */
private void testSpanFlag2()
{
    SpannableStringBuilder builder = new SpannableStringBuilder(text1+text2+text3);
    builder.setSpan(new ForegroundColorSpan(Color.RED), 3, 6, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    //插入文本位置要紧挨span样式 如果不是,那么设置的样式不适用a  后置包括同理。
    builder.insert(3, "a");
    builder.insert(7, "a");
    textView.setText(builder);
}

通过这个方式,确实实现了flag字面上的效果。如上代码的效果如下:

早上好a今晚吃什么?

5)测试SpannaleStringBuilder

如果要实现对一段字符串的不同部分实现不同的格式,就必须要使用SpannaleStringBuilder,下面两个方法的效果是一样的。

/**
 * 测试SpannaleStringBuilder
 */
private void testSpannaleStringBuilder()
{
    SpannableStringBuilder builder = new SpannableStringBuilder(text1+text2+text3);
    builder.setSpan(new ForegroundColorSpan(Color.RED), 0, 3, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    builder.setSpan(new ForegroundColorSpan(Color.YELLOW), 3, 6, Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    builder.setSpan(new ForegroundColorSpan(Color.BLUE), 6, builder.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    textView.setText(builder);
}

private void testSpannaleStringBuilder2()
{
    SpannableStringBuilder builder = new SpannableStringBuilder();
    SpannableString ss1 = new SpannableString(text1);
    ss1.setSpan(new ForegroundColorSpan(Color.RED), 0, text1.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    SpannableString ss2 = new SpannableString(text2);
    ss2.setSpan(new ForegroundColorSpan(Color.YELLOW), 0, text2.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    SpannableString ss3 = new SpannableString(text3);
    ss3.setSpan(new ForegroundColorSpan(Color.BLUE), 0, text3.length(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
    builder.append(ss1).append(ss2).append(ss3);
    textView.setText(builder);
}

6.参考文章

http://www.cnblogs.com/jisheng/archive/2013/01/10/2854088.html

你可能感兴趣的:([Android][SpannableString])