Android Span详解
引子
Android中的Span之前用的很少,接触多了以后,发现Span还是相当有趣的。
Span的命名即便不是最差劲的,也是最差劲的之一吧,第一眼看去完全不知道这个类是干嘛的??。Span字面的意思是“跨度”、“区间”、“范围”,这完全词不达意,一脸懵??。
在Android中,Span用来定义文本的样式。通过Span可以改变几个文字的颜色,让它们可点击,缩放文字大小甚至绘制自己设置的项目符号点。
Span的价值是,可以将这些样式作用在字符级别或者者段落级别。那现在反过来,假如我来写一个这种功能的类,有没有更好的命名呢?呃~ 呃~ 呃~,如同google 大佬的命名还挺香~~~
本文主要分4部分详情、总结下Span(大部分直接翻译了google文档??),(1)Span的使用哲学,(2)Framework中提供的Span武器库,明晰有哪些样式可以直接使用,(3)假如系统未提供样式,如何自己设置Span,(4)使用Span的最佳实践。
Span的使用哲学
Span是专门用来加强TextView样式的,Span通过改变TextPaint属性,在Canvas上绘制,甚至是改变文本的布局和影响像行高这样的元素,来改变文本样式。它可以被应用到部分或者整段的文本中。
TextView有样式属性,为什么还需要Span****?
通过XML属性或者者代码设置即可以改变文本样式,但是效果必需作用于整个文本,假如要在部分文本上使用特殊样式就无能无力了,例如像下面这种:

Span就是处理这种需求的,Span样式可以作用于字符或者者段落级别的文本。
通常使用的套路是样式属性和Span组合使用,可以考虑将设置给TextView的样式属性作为一种“基本”样式,而 Span样式是应用在基本样式“之上”并且会覆盖基本样式的样式。
例如,当给一个 TextView 设置了 textColor=”@color.blue” 属性且设置开头4个字符应用了 ForegroundColorSpan(Color.PINK),则开头4个字符会使用 span 设置的粉色,而其余文本使用 TextView 属性设置的颜色。具体API使用,自行google,或者者查看github的Span Sample。
AndroidDog/SpanSample
<TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:textColor="@color/blue"/>SpannableString spannable = new SpannableString(“Text styling”);spannable.setSpan( new ForegroundColorSpan(Color.PINK), 0, 4, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);myTextView.setText(spannable);
如何创立使用Span
当使用 span 时,需要使用SpannedString, SpannableString 或者 SpannableStringBuilder之一。 它们之间的区别在于text内容或者markup是可改变的还是不可改变的,以及它们使用的内部结构:SpannedString 和 SpannableString 使用线性数组记录已增加的 span,而 SpannableStringBuilder 使用 区间树。

如何决定使用哪一个类:
创立后 文本 和 span 不可变 –> SpannedString
创立后文本不可变,仅需设置 一些的 span (<~ 10)? –> SpannableString
创立后需设置 文本 和 span –> SpannableStringBuilder
创立后需设置 大量的 span (>~ 10)? –> SpannableStringBuilder
比较难了解的是SpanedString,查看其api,可以看到其只能通过SpannableString来创立,复制其Span属性来使用,这是我的了解不知道对不对,有理解的可以指导下。SpanedString使用场景也比较少吧,一直没用过。
对于SpannableString和SpannableStringBuilder,多个 span 可以被组合且同时附加到同一段文本上。如下面的红色和粗体叠加:

Framework中Span样式总结
Android framework在android.text.style包提供了20+的Span样式,通过2个维度可以对Span进行分类:
基于Span能否改变text的外形还是改变text的尺寸或者布局
基于Span的作用范围是字符级别还是或者段落级别

Span的实现原理是,Android framework定义了几个接口和笼统类,这些接口和笼统类有允许Span访问TextPaint或者Canvas对象的方法,它们会在测量和渲染时被检查,达到改变文本样式的效果。
影响text外观的Span
这些Span可以影响text外观:文本或者背景颜色、下划线、删除线等等,如下UML类图所示,类名所见即所得。

这些Span会触发文本重新绘制,而不会触发重新布局。这些 span 实现了 UpdateAppearance 且继承自 CharacterStyle。CharacterStyle的子类通过提供升级 TextPaint 的访问方法,定义了怎么绘制文本。
影响text尺寸或者布局的Span
这些Span可以影响text的尺寸和布局,如文本绝对尺寸、相对尺寸、插入图片、上标、下标、字体、字体风格等,如下UML类图所示,类名所见即所得。这些Span都继承自MetricAffectingSpan。

影响文本字体大小的Span可能会使得text字符宽高变化,甚至多出来一行,其实现是通过监听,触发重新测量、进而重新计算布局,进而重新绘制。这写Span继承自MetricAffectingSpan类,这个笼统类通过提供对 TextPaint的访问,来影响文本测量,而 MetricAffectingSpan 继承自CharacterSpan,其子类在字符级别影响文本的外形。
字符级Span
笼统类CharacterStyle对文本产生的影响在字符级别,升级元素,如背景颜色、样式或者大小,上面的影响text外观、影响text尺寸或者布局的Span都是字符级的Span。
CharacterStyle主要就是一个笼统方法updateDrawState,影响绘制属性,总结下来就是,一支画笔走天下,什么效果都能渲染。
MetricAffectingSpan主要就是一个笼统方法updateMeasureState,影响测量,进而重新布局。

段落级Span
段落级别Span都实现了接口ParagraphStyle(空接口),这些Span可以更改整个文本块的对齐方式或者者边距。继承自ParagraphStyle的Span必需作用于text整体,从第一个字符附加到单个段落的最后一个字符,否则Span不会被显示。
在 Android 中,段落是基于换行符 (\n) 定义的。

Framework中段落级的Span,如下UML类图所示,类名所见即所得。可以看到很多接口没有实现,系统是预留了很多能力的,方便自己设置。

自己设置Span
系统提供的Span样式虽多,但是未必有一款合你心意,自己设置Span总是在所难免。在实现你自己的Span时,需要确定你的Span是会影响字符级别还是影响段落级别的文本,以及它是影响文本的布局还是影响文本的外观,据此选择需要扩展的基类和实现的接口。相应选择如下:

举个例子,你需要Span样式可以改变文本的大小和颜色。你可以扩展RelativeSizeSpan,因为 RelativeSizeSpan已经提供了updateDrawState和updateMeasureState回调,我们可以复写绘制状态回调并设置 TextPaint 的颜色。这只是一个自己设置Span的例子而已,同样的效果你可以通过组合使用RelativeSizeSpan和ForegroundColorSpan来达成。
public class RelativeSizeColorSpan extends RelativeSizeSpan { private int color; public RelativeSizeColorSpan(float spanSize, int spanColor) { super(spanSize); color = spanColor; } @Override public void updateDrawState(TextPaint textPaint) { super.updateDrawState(textPaint); textPaint.setColor(color); }}Span使用最佳实践
基于使用场景,TextView#setText()方法有几种优化内存的方式。原理是,setText方法会copy一份text实例,在某些场景可以规避创立copy text实例。
text不变添加或者移除Span
TextView#setText()因解决不同的Span有多个重载,例如,设置一个Spannable text:
textView.setText(spannableObject);当调用setText()方法,TextView会copy Spannable作为SpannableString,并在内存中以CharSequence形态保存。这意味着text和Span是不可变的,当需要升级text和Span时,需要创立新的Spannable,并且调用setText()。
假如Span是可变的,使用setText(CharSequence text, TextView.BufferType type)更佳, 如下:
textView.setText(spannable, BufferType.SPANNABLE);Spannable spannableText = (Spannable) textView.getText();spannableText.setSpan( new ForegroundColorSpan(color), 8, spannableText.getLength(), SPAN_INCLUSIVE_INCLUSIVE);上例中,因为BufferType.SPANNABLE参数,setText方法创立了SpannableString(可变markup,不可变文本),再次升级Span时,可以获取TextView中的Spannable引用,而非再次创立新的Spannable实例,优化内存使用。
需要注意的是,此时需要主动调用invalidate() 或者者requestLayout(),根据升级的Span是影响外观的,还是影响尺寸和布局的而定。
TextView屡次设置text
少量场景,比方RecyclerView.ViewHolder,存在TextView复用,导致屡次设置text。
通常不使用BufferType参数的情况下,每次设置文本,TextView都会copy一份实例,以CharSequence的形态存在内存中。也就是,每次设置新的文本,TextView都会创立新的实例。
通过实现自己的Spannable#Factory并重写newSpannable()可以控制这个过程,并避免多余实例的创立。范例如下:
Spannable.Factory spannableFactory = new Spannable.Factory(){ @Override public Spannable newSpannable(CharSequence source) { return (Spannable) source; }};需要注意的是,必需使用textView.setText(spannableObject, BufferType.SPANNABLE)这种方式设置文本,否则就会抛出ClassCastException。
需要告诉TextView使用自己设置的Spannable#Factory,如下:
textView.setSpannableFactory(spannableFactory);在取得TextView引用之后需要立刻设置,假如在使用RecyclerView,应该在view第一次被inflate出来之后立刻设置Factory,避免绑定数据时TextView#setText()出现多余的实例创立。
改变Span属性
假如需要改变一个可变Span的内部属性,比方改变BulletSpan的颜色,避免屡次重头调用setText()方法,最佳实现方式是,保存Span的引用,再需要升级Span属性时,通过引用改变属性,而后调用invalidate() 或者者 requestLayout()方法。
BulletSpan颜色改变的范例如下:
public class MainActivity extends AppCompatActivity { private BulletPointSpan bulletSpan = new BulletPointSpan(Color.RED); @Override protected void onCreate(Bundle savedInstanceState) { ... SpannableString spannable = new SpannableString("Text is spantastic"); // setting the span to the bulletSpan field spannable.setSpan(bulletSpan, 0, 4, Spanned.SPAN_INCLUSIVE_INCLUSIVE); styledText.setText(spannable); button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { // change the color of our mutable span bulletSpan.setColor(Color.GRAY); // color won’t be changed until invalidate is called styledText.invalidate(); } }); }}使用Android KTX扩展
Android KTX扩展包括了很多更方便使用Span的方法,具体可以参考androidx.core.text。
Android开发资料+面试架构资料 免费分享 点击链接 就可领取
《Android架构师必备学习资源免费领取(架构视频+面试专题文档+学习笔记)》
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » Android Span详解