Android Span详解

作者 : 开心源码 本文共6012个字,预计阅读时间需要16分钟 发布时间: 2022-05-13 共431人阅读

引子

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详解

发表回复