Android安卓中的TextView自动调整文字大小——Autosizing功能详解

Android 8.0 已经发布了有一阵子了&＃xff0c;如果你有在关注它&＃xff0c;你应该会知道它新增了一个对于 TextView 字体大小变动的新特性&＃xff1a;Autosizing。

本身这个新特性&＃xff0c;如果只是在 Android 8.0 才有效&＃xff0c;对于开发者而言&＃xff0c;就显得有点鸡肋了&＃xff0c;可能还需要一段时间才能普及使用。不过呢&＃xff0c;在 Android Support v26 之上&＃xff0c;也对 Autosizeing 提供了兼容支持&＃xff0c;最低可以支持到 Android Level 14。

这样&＃xff0c;我们就有了研究的必要了&＃xff0c;接下来本文就来讲解一下&＃xff0c;Autosizeing 属性&＃xff0c;你在使用过程中的所有细节。

Autosizeing 允许 TextView 根据其内部文本的显示大小&＃xff0c;动态的调整其 TextSize 属性值得大小&＃xff0c;通过此设置&＃xff0c;开发者可以很轻松的在具有动态内容的情况下&＃xff0c;对不同的屏幕中&＃xff0c;文本大小进行优化。

简单来说&＃xff0c;一个 100dp 长度的 TextView &＃xff0c;正常来说只能显示 10 个 10dp 的文字&＃xff0c;而如果它的内容超出了 10 个字&＃xff0c;以前的通用做法&＃xff0c;是通过属性设置&＃xff0c;让它在末尾显示 “…” 。而采用了 Autosizeing 这个新特性&＃xff0c;它的方案是将字体的尺寸缩小&＃xff0c;例如缩小到 8dp&＃xff0c;让 TextView 可以容纳下更多的文字&＃xff0c;显示完全。而这一切&＃xff0c;使用 Autosizeing 我们只需要设置一些属性就可以做到&＃xff0c;非常的简单。

上面这个 Gif 应该可以很直观的描述 Autosizeing 的特性&＃xff0c;而它也反映出&＃xff0c;触发 Autosizeing 重新计算 TextSize 的时机有两个&＃xff1a;

1. TextView 中的文字增多到无法容纳的地步。
2. TextView 本身的尺寸被放大或缩小了。

Autosizeing 的核心设计思想&＃xff0c;就是为了让 文本 尽可能的完全显示在既定大小的 TextView 中&＃xff0c;哪怕是修改它的文字大小。

2.1 Autosizeing 不同使用方式

前面也提到&＃xff0c;使用 Autosizeing 其实是区分使用 Android Api Level 26&＃xff08;8.0&＃xff09; 和 使用 Support Library v26 两种。它们的使用方式&＃xff0c;会略微有点区别。

下面&＃xff0c;我们先来了解一下它们之间的区别。
Autosizeing 的带来的效果很简单&＃xff0c;就是根据文字的内容&＃xff0c;动态修改 TextSize &＃xff0c;而想要使用它&＃xff0c;可以通过动态编码和静态的 layout-xml 布局属性的方式使用。

对于 Android 8.0 Api&＃xff1a;

1. 动态编码是直接操作的 TextView 上的方法。
2. layout-xml 布局属性&＃xff0c;是使用的 android: 命名空间下的属性进行设置。

而在低于 Android 8.0 的设备上&＃xff0c;只能使用 Support v26 了。此时&＃xff0c;TextView 上并没有对应的方法能让我们调用&＃xff0c;所以我们需要绕一层。

1. 动态编码&＃xff0c;使用 TextViewCompat 中提供的方法。
2. layout-xml 布局属性&＃xff0c;需要使用 app: 命名空间下的属性&＃xff0c;记住要添加 xmlns:app&＃61;"http://schemas.android.com/apk/res-auto"这个命名空间。

使用标准的 8.0 Api 的使用场景&＃xff0c;在现阶段会非常的少&＃xff0c;所以我们这里只是简单了解一下区别就好了&＃xff0c;下面的文章内容会主要以 Support v26 的方式进行讲解。

2.2 Autosizeing 基础

到这里&＃xff0c;你应该对 Autosizeing 有了基本的概念&＃xff0c;知道它是干什么的。
那么&＃xff0c;如果让你来设计一个这样的功能&＃xff0c;你会想要做到哪些点&＃xff1f;

1. 有开关限制&＃xff0c;只在我们需要的 TextView 上&＃xff0c;才开启这个特性。
2. 允许设置边界值&＃xff0c;最大缩放和最小缩放。
3. 能配置每次缩放的最小尺寸&＃xff0c;例如&＃xff1a;10sp 为粒度进行缩放。
4. 能预设一些缩放的定位尺寸&＃xff0c;例如预设一组尺寸&＃xff0c;只让它在这个范围内的值中选一个。
5. 方便的 Api &＃xff0c;可以通过 layout-xml 属性和动态编码的方式操作它。

嗯&＃xff0c;功能上大概就是这些了&＃xff0c;已经满足我的需要了。
如果你看了 Autosizeing 的文档Autosizeinging TextView Doc&＃xff0c;你会发现&＃xff0c;它全部都支持&＃xff01;

2.3 Autosizeing 开关

Autosizeing 是直接作用在 TextView 上的&＃xff0c;对于它的开启和关闭&＃xff0c;我们可以直接操作 autoSizeTextType 属性。

对于动态编码&＃xff0c;可以使用 TextViewCompat 的 setAutosizeingTextTypeWithDefaults() 方法&＃xff0c;下面是它的方法签名。

参数中的 textView 是我们要操作的 TextView&＃xff0c;而 autoSizeTextType&＃xff0c;就是我们关心的 Autosizeing 的开关属性了&＃xff0c;它接受两个参数。

• AUTO_SIZE_TEXT_TYPE_NONE&＃xff1a;关闭自动调整功能。
• AUTO_SIZE_TEXT_TYPE_UNIFORM&＃xff1a;开启统一缩放碎片轴和垂直轴。

我们也可以通过 layout-xml 属性的方式&＃xff0c;来设置 autoSizeTextType&＃xff0c;因为是 Support &＃xff0c;所以使用的 app&＃xff1a; 命名空间下的属性。

app:autoSizeTextType 同样接收两个参数 uniform 和 none&＃xff0c;含义和上面代码中设置的参数一致。

2.4 操作 Autosizeing 的粒度

粒度的含义其实就是 Autosizeing 每次变动的最小单位&＃xff0c;当然在设置粒度的同时&＃xff0c;你还需要为其设置一个缩放的范围&＃xff0c;最大值和最小值。

这样&＃xff0c;在 Autosizeing 生效的时候&＃xff0c;它会在这个范围内&＃xff0c;按照我们设定的粒度&＃xff0c;去动态的调整文字的大小。
想要操作这些属性&＃xff0c;动态编码的方式你需要调用 TextViewCompat 的 setAutosizeingTextTypeUniformWithConfiguration() 方法。

参数很直观&＃xff0c;没什么好解释的&＃xff0c;一个最小值、一个最大值、变动的粒度、前面设置的尺寸的单位。

我们可以通过 unit 参数&＃xff0c;通过 TypedValue 来设置前面设置的几个参数的单位&＃xff0c;例如&＃xff1a;sp 、dp、px&＃xff0c;都可以。

这里操作的参数&＃xff0c;在 layout-xml 中&＃xff0c;都提供了对应的属性可供我们使用。

下面我们举两个例子看看&＃xff0c;就清晰了。

在默认情况下&＃xff0c;如果你没有设置这三个属性&＃xff0c;Autosizeing 会根据当前 TextView 控件的大小&＃xff0c;估算出一个最大值和最小值&＃xff0c;并且将粒度设置为 1sp 。

可以看到&＃xff0c;它设置的尺寸是跳动的&＃xff0c;非常的不可控&＃xff0c;我们很难知道下一次缩放&＃xff0c;会将 文本 尺寸&＃xff0c;设置成多大&＃xff0c;所以才需要使用 粒度 的概念来限制它缩放的大小。

例如&＃xff0c;现在我们修改上面的例子&＃xff0c;将&＃xff08;minSize,maxSize&＃xff09;&＃xff0c;限制在 &＃xff08;10sp,80sp&＃xff09;之间&＃xff0c;粒度&＃xff08;Granularity&＃xff09;设置为 10sp&＃xff0c;此时再来看它的效果。

到这里可以看到&＃xff0c;它每次放大或者缩小&＃xff0c;粒度都是以 10sp 为基准。
所以&＃xff0c;如果你需要使用 Autosizeing &＃xff0c;强烈建议你使用 粒度 来控制它缩放的大小&＃xff0c;让它在可控的范围内使用。需要注意的是&＃xff0c;这里介绍的三个属性&＃xff0c;一定要设置在一个合理的范围内&＃xff0c;否则 TextView 会认为这是一个无效的设置&＃xff0c;将它忽略掉。

2.5 预设尺寸范围

如果你按上一小节&＃xff0c;介绍的属性&＃xff0c;设置了 Autosizeing 的粒度&＃xff0c;就可以在这个范围内&＃xff0c;根据我们设置的粒度进行缩放。通常&＃xff0c;使用粒度来控制基本上可以达到我们的要求&＃xff0c;但是如果对缩放有更精准的要求&＃xff0c;例如&＃xff1a;[10.15,40,60,100] 这样的缩放&＃xff0c;使用粒度就达不到我们的要求了。

针对这样的操作&＃xff0c;Autosizeing 也提供了对应的属性来设置&＃xff0c;那就是 预设尺寸&＃xff08;Preset Size&＃xff09;。

如果想要使用预设尺寸&＃xff0c;动态编码的方式&＃xff0c;你需要操作 TextViewCompat 的 setAutosizeingTextTypeUniformWithPresetSizes() 方法。

预设尺寸可以接受一个尺寸数组&＃xff0c;Autosizeing 就会从我们设定的尺寸数组中&＃xff0c;取一个尺寸进行设置。同时你可以为这些尺寸设置一个统一的尺寸单位。
如果想要在 layout-xml 使用属性的形式使用预设尺寸&＃xff0c;你首先需要一个 array 的资源&＃xff0c;然后通过 autoSizePresetSizes 属性进行设置即可。
array 资源的格式&＃xff1a;

10sp12sp20sp40sp100sp



定义好 array 的尺寸资源之后&＃xff0c;就可以在 layout-xml 中使用它。

预设尺寸非常简单&＃xff0c;这里就不再给运行效果了。

到这里&＃xff0c;我们就把 Autosizeing 的基本使用细节&＃xff0c;都讲解清楚了。但是&＃xff0c;依然还有一些概念&＃xff0c;是在文档上没有反应出来的&＃xff0c;下面我们就来讲讲这些 “经验”。

3.1 TextView 必须限定尺寸

如果你想要使用 Autosizeing&＃xff0c;就必须对 TextView 这个控件&＃xff0c;限定大小&＃xff0c;不能使用 wrap_content 来作为限定符。
用官方文档话来说&＃xff0c;使用 wrap_content 可能出现不可预料的效果。其实这也非常好理解&＃xff0c;如果 TextView 的尺寸不是固定的&＃xff0c;那就不存在 TextView 重新计算尺寸的依据了&＃xff0c;同比放大 TextView 就可以达到容纳文字的效果了。
我在实际使用过程中会发现&＃xff0c;它会阻止放大效果。例如一个 TextView 中使用了 Autosizeing&＃xff0c;一直增加文本内容&＃xff0c;是可以正常缩小的&＃xff0c;但是当你删除文本的时候&＃xff0c;它并不会随之放大文字尺寸。
但是不确定还有没有其它的问题&＃xff0c;这里建议按照官方文档的建议来操作&＃xff0c;限定 TextView 的尺寸。

3.2 Autosizeing 不能作用在 EditText 中

虽然通常作用在 TextView 上的新属性&＃xff0c;对于同样用于显示文本的控件&＃xff0c;例如&＃xff1a;Button、EditText 等&＃xff0c;都是同样适用的。
但是 Autosizeing 就是这么特殊&＃xff0c;它只对单纯只能显示 文本 的控件有效&＃xff0c;例如 Button&＃xff0c;而对于 EditText 这种可以输入 文本 的控件&＃xff0c;是无效的。
这个&＃xff0c;你可以在 AppCompatTextViewAutosizeingHelper 这个类的 supportsAutosizeingText() 方法中找到答案&＃xff0c;它是一个兼容类&＃xff0c;用于向下兼容 Autosizeing 特性。

这里可以看到&＃xff0c;只要不是 AppCompatEditText 就返回 true&＃xff0c;注释也说明了这一点。
暂时没有想到这样设计的原因&＃xff0c;可能是因为输入文本的控件&＃xff0c;本身长度就是在经常变化的&＃xff0c;是一个极端不可控的情况&＃xff0c;所以应该为输入的控件&＃xff0c;限定一个固定的尺寸。

3.3 预设尺寸不一定都命中

如果想要控制文字的缩放尺寸为限定的范围内&＃xff0c;例如使用 粒度 限定它在一个 10sp 的精度下缩放&＃xff1b;或者使用预设尺寸&＃xff0c;限定一些尺寸&＃xff0c;让它只能使用我们预定的一些尺寸。
但是这些&＃xff0c;并不是一定的。
例如&＃xff0c;我们使用预设尺寸&＃xff0c;预设了一组[10sp,20sp,25sp,40sp]&＃xff0c;这样一组尺寸&＃xff0c;其中&＃xff0c;可能某个尺寸就永远不会被命中&＃xff0c;例如 25sp。
这是因为&＃xff0c;Autosizeing 在起作用的时候&＃xff0c;会去计算尺寸是否合适&＃xff0c;假如到 20sp 之后&＃xff0c;再减少文字&＃xff0c;这个时候先获取 25sp &＃xff0c;通过计算发现 25sp 也放不下这些文字&＃xff0c;就会直接跳到 40sp 这个尺寸上去。
所以&＃xff0c;并不是我们设定的尺寸&＃xff0c;它就是以线性的方式去获取尺寸。

3.4 和 singleLine 冲突

如果你想在 TextView 中&＃xff0c;只显示一行文字&＃xff0c;在之前你可以使用 android:singleLine 这个属性&＃xff0c;对其标记。而如果你 同事使用 Autosizeing&＃xff0c;你会发现 AutoSizeing 就不再生效&＃xff0c;它会在末尾显示 “…”。
所幸的是&＃xff0c;android:singleLine 已经被标记为废弃&＃xff0c;所以本身我们就不建议使用它&＃xff0c;如果你想让 TextView 只显示单行文字&＃xff0c;可以使用 android:maxLines&＃61;“1” 属性&＃xff0c;它是可以正常和 Autosizeing 兼容的。

Autosizeing 说起来非常的简单&＃xff0c;但是它能有哪些适用场景呢&＃xff1f;简单说说我能想到的一些适用场景吧&＃xff0c;大家可以开放思维。

4.1 限定条目的 UI

这个&＃xff0c;其实很常见&＃xff0c;例如一些选择题的 UI&＃xff0c;当你有多个需要选择答案的 UI &＃xff0c;并列的显示出来。如果它们的文字长度是可变的&＃xff08;通常都是可变的&＃xff09;&＃xff0c;你除了放大某一行的高度之外&＃xff0c;现在还可以使用 Autosizeing 来控制它的大小。
例如最近比较火的冲顶大会类 App&＃xff0c;就是一个标准的选择题的 UI 布局。

我们可以在答案文字过多的时候&＃xff0c;使用 Autosizeing 将它缩小&＃xff0c;就能正好放在这个既定大小的选项 UI 中。

4.2 多语言

Autosizeing 在 App 的多语言适配中&＃xff0c;也可以大放异彩。
首先你要考虑到&＃xff0c;当你想让 App 适配多语言的话&＃xff0c;一个很严重的问题&＃xff0c;就是不同的语言&＃xff0c;描述同一个词的时候&＃xff0c;长度是不一致的。
例如中文下简单的一句&＃xff1a;我是 Android 开发者&＃xff0c;翻译成不同的语言&＃xff0c;长度是不一致的。
• 英语&＃xff1a;I am an Android developer
• 阿拉伯语&＃xff1a;أنا مطور الروبوت
• 意大利语&＃xff1a;Sono uno sviluppatore Android
• 德语&＃xff1a;Ich bin ein Android-Entwickler
• 法语&＃xff1a;Je suis un développeur Android
在这样的情况下&＃xff0c;我们如果有 Autosizeing 就非常的好解决这个问题了。

本文到这里&＃xff0c;就已经完成了 Autosizeing 的所有细节&＃xff0c;从基本使用到注意事项&＃xff0c;应该算是解释的很详细了。
不知道你觉得 Autosizeing 在实际使用中&＃xff0c;还有什么使用场景&＃xff1f;可以在评论中留言&＃xff0c;分享给大家&＃xff01;

本文参考来源:
[1]https://www.jianshu.com/p/cf4fddbb99df?utm_campaign&＃61;maleskine&utm_content&＃61;note&utm_medium&＃61;seo_notes&utm_source&＃61;recommendation