SpannableString详解

最近用到SpannableString孙便查了一下

背景介绍

在开发应用过程中经常会遇到显示一些不同的字体风格的信息犹如默认的LockScreen上面的时间和充电信息。对于类似的情况，可能第一反应就是用不同的多个TextView来实现，对于每个TextView设置不同的字体风格以满足需求。

 

这里推荐的做法是使用android.text.*;和 android.text.style.*;下面的组件来实现RichText：也即在同一个TextView中设置不同的字体风格。对于某些应用，比如文本编辑，记事本，彩信，短信等地方，还必须使用这些组件才能达到想到的显示效果。

 

主要的基本工具类有android.text.Spanned; android.text.SpannableString; android.text.SpannableStringBuilder;使用这些类来代替常规String。SpannableString和 SpannableStringBuilder可以用来设置不同的Span，这些Span便是用于实现Rich Text，比如粗体，斜体，前景色，背景色，字体大小，字体风格等等，android.text.style.*中定义了很多的Span类型可供使用。

 

这是相关的API的Class General Hierarchy：


 

因为Spannable等最终都实现了CharSequence接口，所以可以直接把SpannableString和SpannableStringBuilder通过TextView.setText()设置给TextView。

 

使用方法

 

当要显示Rich Text信息的时候，可以使用创建一个SpannableString或SpannableStringBuilder，它们的区别在于 SpannableString像一个String一样，构造对象的时候传入一个String，之后再无法更改String的内容，也无法拼接多个 SpannableString；而SpannableStringBuilder则更像是StringBuilder，它可以通过其append()方法来拼接多个String：

 

SpannableString word = new SpannableString("The quick fox jumps over the lazy dog");

SpannableStringBuilder multiWord = new SpannableStringBuilder();
multiWord.append("The Quick Fox");
multiWord.append("jumps over");
multiWord.append("the lazy dog");

创建完Spannable对象后，就可以为它们设置Span来实现想要的Rich Text了，常见的Span有：

AbsoluteSizeSpan(int size) ---- 设置字体大小，参数是绝对数值，相当于Word中的字体大小
RelativeSizeSpan(float proportion) ---- 设置字体大小，参数是相对于默认字体大小的倍数，比如默认字体大小是x, 那么设置后的字体大小就是x*proportion，这个用起来比较灵活，proportion>1就是放大(zoom in), proportion<1就是缩小(zoom out)

ScaleXSpan(float proportion) ---- 缩放字体，与上面的类似，默认为1,设置后就是原来的乘以proportion，大于1时放大(zoon in)，小于时缩小(zoom out)
BackgroundColorSpan(int color) ----背景着色，参数是颜色数值，可以直接使用android.graphics.Color里面定义的常量，或是用Color.rgb(int, int, int)
ForegroundColorSpan(int color) ----前景着色，也就是字的着色，参数与背景着色一致
TypefaceSpan(String family) ----字体，参数是字体的名字比如“sans", "sans-serif"等
StyleSpan(Typeface style) -----字体风格，比如粗体，斜体，参数是android.graphics.Typeface里面定义的常量，如Typeface.BOLD，Typeface.ITALIC等等。
StrikethroughSpan----如果设置了此风格，会有一条线从中间穿过所有的字，就像被划掉一样
对于这些Sytle span在使用的时候通常只传上面所说明的构造参数即可，不需要设置其他的属性，如果需要的话，也可以对它们设置其他的属性，详情可以参见文档。
SpannableString和SpannableStringBuilder都有一个设置上述Span的方法：

 

其中参数what是要设置的Style span，start和end则是标识String中Span的起始位置，而 flags是用于控制行为的，通常设置为0或Spanned中定义的常量，常用的有：

Spanned.SPAN_EXCLUSIVE_EXCLUSIVE --- 不包含两端start和end所在的端点

Spanned.SPAN_EXCLUSIVE_INCLUSIVE
--- 不包含端start，但包含end所在的端点
Spanned.SPAN_INCLUSIVE_EXCLUSIVE
--- 包含两端start，但不包含end所在的端点
Spanned.SPAN_INCLUSIVE_INCLUSIVE--- 包含两端start和end所在的端点
这里理解起来就好像数学中定义区间，开区间还是闭区间一样的。还有许多其他的Flag，可以参考这里。这里要重点说明下关于参数0,有很多时候，如果设置了上述的参数，那么Span会从start应用到Text结尾，而不是在start和end二者之间，这个时候就需要使用Flag
0。

Linkify

另外，也可以对通过TextView.setAutoLink(int)设置其Linkify属性，其用处在于，TextView会自动检查其内容，会识别出phone
number, web address or email address，并标识为超链接，可点击，点击后便跳转到相应的应用，如Dialer，Browser或Email。Linkify有几个常用选项，更多的请参考文档：

Linkify.EMAIL_ADDRESS -- 仅识别出TextView中的Email在址，标识为超链接，点击后会跳到Email，发送邮件给此地址

Linkify.PHONE_NUMBERS -- 仅识别出TextView中的电话号码，标识为超链接，点击后会跳到Dialer，Call这个号码
Linkify.WEB_URLS--
仅识别出TextView中的网址，标识为超链接，点击后会跳到Browser打开此URL
Linkify.ALL -- 这个选项是识别出所有系统所支持的特殊Uri，然后做相应的操作
 

SpannableString 属性：

 
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
文本超链接