前言
上一篇文章还是今年四月份写的,期间也尝试写过几篇文章, 但是都因繁忙的工作只能暂时的放下。此刻其实手上还是有很多需求没有完成,但是我觉着有必要把今天学到的这个知识点分享一下。因为,关于这个知识点虽然很简单,但是却发现目前网上的一些文章写的真是不怎么用心,都是陈述这个问题很好解决,然后文章也附上了实现的代码,但是按照作者写的实现方式本地去运行却发现是无效的。下面我来描述下这个问题的场景以及解决方案。
关于AutoSizeableTextView
公司上个版本中有这样一个需求,要求在一个列表中的每个条目中展示字数不限个数的文本。而且每个条目的宽度都是固定的,展示的文本如果过长,不可以用省略号显示,只能动态的调整(缩小)文本的字号来达到文本能完全显示的效果,而且要限一行展示。关于这个效果,其实目前android官方已经提供了实现方式。那就是AutoSizeableTextView。
文章的标题我之所以给AutoSizeableTextView加了双引号,其实是因为,我们如果只看这个名字,会觉着这应该是android新推出的一个功能更强大的TextView控件(起初我也是这样认为的)。但如果我们点进到源码中会发现,其实它是一个接口。关于这个接口,详情还请自行阅读哈。(https://developer.android.com/guide/topics/ui/look-and-feel/autosizing-textview)
在Android 8.0,android提供了这样一个接口用来实现上面我所描述的这个效果。当然,官方推出这个接口之前,估计已经有很多网上的案例通过自定义View的方式实现了这个效果。可必须承认的一点是,人家官方提供的东西应该比你自己实现的东西要靠谱些吧(大神请见谅)。虽然这个接口是8.0才提出的,但是为了让以前的低版本也能实现这个效果,官方提供了相应的兼容举措的,下面我针对两种方式进行介绍。
在XML中设置
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto" // 加入app命名空间
android:layout_width="match_parent"
android:layout_height="@dimen/dimen_45">
<android.support.v7.widget.AppCompatTextView
android:layout_width="@dimen/dimen_105"
android:layout_height="@dimen/dimen_32"
android:maxLines="1"
android:textSize="@dimen/dimen_sp_12"
android:textColor="@color/button_r_b_font_color"
app:autoSizeTextType="uniform" // 设置TextView大小设置样式为支持改变(none时为不支持改变)
app:autoSizeStepGranularity="@dimen/lib_search_dimen_sp_1" // 每次改变的尺寸阶梯
app:autoSizeMinTextSize="@dimen/lib_search_dimen_sp_8"
app:autoSizeMaxTextSize="@dimen/lib_search_dimen_sp_12" />
</RelativeLayout>
这里采用AppCompatTextView,它是谷歌为了兼容老版本而提供的一个新的类,它实现了AutoSizeableTextView接口, 在xml中通过引入app空间下的对应几个属性,就可以实现上述根据控件宽度来自适应文字的大小的效果。
在代码中动态设置
首先,在布局中声明控件,注意需要声明的是AppCompatTextView。
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="@dimen/dimen_45">
<android.support.v7.widget.AppCompatTextView
android:id="@+id/txt_price_section_item"
android:layout_width="@dimen/dimen_105"
android:layout_height="@dimen/dimen_32"
android:background="@drawable/red_black_selector_bg"
android:maxLines="1"
android:textSize="@dimen/dimen_sp_12"
android:textColor="@color/button_r_b_font_color" />
</RelativeLayout>
在代码中进行改变字号的设置
TextViewCompat.setAutoSizeTextTypeWithDefaults(textView, TextViewCompat.AUTO_SIZE_TEXT_TYPE_UNIFORM);
TextViewCompat.setAutoSizeTextTypeUniformWithConfiguration(textView, 8, 25, 1, TypedValue.COMPLEX_UNIT_SP);
就这两行代码,首先第一个方式是设置TextView字号支持改变大小模式。第二个方法,根据参数的命名我们也能猜出含义,和上面在xml置顶的几个属性是一样的,这里我不再复述(最后一个参数是尺寸单位)。
这里需要说明三点,
1.首先为什么在xml中声明的控件必须是AppCompatTextView。我们点击上面的第二个方法的源码中看一下:
public static void setAutoSizeTextTypeUniformWithConfiguration(@NonNull TextView textView, int autoSizeMinTextSize, int autoSizeMaxTextSize, int autoSizeStepGranularity, int unit) throws IllegalArgumentException {
if (VERSION.SDK_INT >= 27) {
textView.setAutoSizeTextTypeUniformWithConfiguration(autoSizeMinTextSize, autoSizeMaxTextSize, autoSizeStepGranularity, unit);
} else if (textView instanceof AutoSizeableTextView) {
((AutoSizeableTextView)textView).setAutoSizeTextTypeUniformWithConfiguration(autoSizeMinTextSize, autoSizeMaxTextSize, autoSizeStepGranularity, unit);
}
}
看到了吧,其实是为了兼容老版本,如果你的项目不针对27以下的版本进行兼容,你完全可以直接在xml中声明TextView控件,而且在xml中也可以直接用android声明的那几个属性进行设置,无须再引入app空间下的属性。而当低于27的时候,这个TextView必须属于AutoSizeableTextView类型的,而前面已经说过,AppCompatTextView实现了AutoSizeableTextView接口,因此,为了兼容老版本,我们在xml声明的时候需要声明为AppCompatTextView。
2.其次,要说到一个特别要注意的事情,那就是控件的宽度和高度必须要有具体的值,不能设置为wrap_content。这一点估计也好理解,如果宽高不固定,也就不会有根据宽高改变字号这一问题了。
3.最后,关于一行展示这个属性,平时我们应该都知道两种方式。那就是singleLine="true",或者maxLines="1"。看我上面的代码,两种方式我都采用的是maxLines="1"的方式进行设置,如果用singleLine的话会发现无法显示预期的效果的。