官方提供的自动改变文本大小的“TextView”

关于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。

小编注：关于第一点，应该是有个前提，如果是继承自AppCompatActivity,可以直接使用，系统会自动将TextView这个
tag 生成AppCompatTextView实例对象，但是如果是自己做了自定义等操作，一定要继承AppCompatTextView。

之前也推送给相关原理的文章：

Android两行代码实现换肤从appcompat-v7原理出发
https://blog.csdn.net/ximsfei/article/details/54604310

2、其次，要说到一个特别要注意的事情，那就是控件的宽度和高度必须要有具体的值，不能设置为wrap_content。这一点估计也好理解，如果宽高不固定，也就不会有根据宽高改变字号这一问题了。

3、最后，关于一行展示这个属性，平时我们应该都知道两种方式。那就是singleLine=“true”,或者maxLines=“1”。看我上面的代码，两种方式我都采用的是maxLines="1"的方式进行设置，如果用singleLine的话会发现无法显示预期的效果的。

结语

以上，就是使用android官方提供的方法来实现TextView根据宽高自动改变文本大小的方式！，希望能够对大家有所帮助！