自动调整 TextView 大小

从 Android 8.0（API 级别 26）及更高版本开始，您可以指示 TextView 自动扩展或收缩文本大小以根据 TextView 的特性和边界填充其布局。此设置使优化不同屏幕上具有动态内容的文本大小变得更加容易。

支持库 26.0 完全支持在运行 Android 8.0（API 级别 26）或更低版本的设备上自动调整 TextView 功能。 android.support.v4.widget 包含 TextViewCompat 类，以便以向后兼容的方式访问功能。

设置 TextView 自动调整大小

您可以使用框架或支持库以编程方式或在 XML 中设置 TextView 的自动调整大小。要设置 XML 属性，您也可以使用 Android Studio 中的“属性”窗口。

有三种方法可以设置 TextView 的自动调整大小，如下面的部分所述

• 默认
• 粒度
• 预设大小

注意：如果您在 XML 文件中设置自动调整大小，我们不建议为 TextView 的 layout_width 或 layout_height 属性使用值“wrap_content”。这样做可能会产生意外的结果。

默认

默认设置允许 TextView 的自动调整大小在水平和垂直轴上统一缩放。

• 要以编程方式定义默认设置，请调用 setAutoSizeTextTypeWithDefaults(int autoSizeTextType) 方法。提供 AUTO_SIZE_TEXT_TYPE_NONE 以关闭自动调整大小功能，或提供 AUTO_SIZE_TEXT_TYPE_UNIFORM 以统一缩放水平和垂直轴。

注意：统一缩放的默认尺寸为 minTextSize = 12sp、maxTextSize = 112sp 和 granularity = 1px.

• 要在 XML 中定义默认设置，请使用 android 命名空间并将 autoSizeTextType 属性设置为 none 或 uniform。

<?xml version="1.0" encoding="utf-8"?>
<TextView
    android:layout_width="match_parent"
    android:layout_height="200dp"
    android:autoSizeTextType="uniform" />

使用支持库定义默认设置

• 要通过支持库以编程方式定义默认设置，请调用 TextViewCompat.setAutoSizeTextTypeWithDefaults(TextView textview, int autoSizeTextType) 方法。提供 TextView 窗口小部件的实例和其中一种文本类型，例如 TextViewCompat.AUTO_SIZE_TEXT_TYPE_NONE 或 TextViewCompat.AUTO_SIZE_TEXT_TYPE_UNIFORM。
• 要通过支持库在 XML 中定义默认设置，请使用 app 命名空间并将 autoSizeTextType 属性设置为 none 或 uniform。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <TextView
      android:layout_width="match_parent"
      android:layout_height="200dp"
      app:autoSizeTextType="uniform" />

</LinearLayout>

粒度

您可以定义最小和最大文本大小的范围以及指定每个步骤大小的维度。 TextView 在最小和最大大小属性之间的范围内统一缩放。每次增量都作为粒度属性中设置的步长大小发生。

• 要以编程方式定义文本大小范围和维度，请调用 setAutoSizeTextTypeUniformWithConfiguration(int autoSizeMinTextSize, int autoSizeMaxTextSize, int autoSizeStepGranularity, int unit) 方法。提供最大值、最小值、粒度值和任何 TypedValue 尺寸单位。
• 要在 XML 中定义文本大小范围和维度，请使用 android 命名空间并设置以下属性
  • 将 autoSizeTextType 属性设置为 none 或 uniform。 none 值是默认值，而 uniform 允许 TextView 在水平和垂直轴上统一缩放。
  • 设置 autoSizeMinTextSize、autoSizeMaxTextSize 和 autoSizeStepGranularity 属性以定义 TextView 自动调整大小的尺寸。

<?xml version="1.0" encoding="utf-8"?>
<TextView
    android:layout_width="match_parent"
    android:layout_height="200dp"
    android:autoSizeTextType="uniform"
    android:autoSizeMinTextSize="12sp"
    android:autoSizeMaxTextSize="100sp"
    android:autoSizeStepGranularity="2sp" />

使用支持库定义粒度

• 要通过支持库以编程方式定义文本大小范围和维度，请调用 TextViewCompat.setAutoSizeTextTypeUniformWithConfiguration(int autoSizeMinTextSize, int autoSizeMaxTextSize, int autoSizeStepGranularity, int unit) 方法。提供最大值、最小值、粒度值和任何 TypedValue 尺寸单位。
• 要通过支持库在 XML 中定义文本大小范围和维度，请使用 app 命名空间并在布局 XML 文件中设置 autoSizeText、autoSizeMinTextSize、autoSizeMaxTextSize 和 autoSizeStepGranularity 属性。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <TextView
      android:layout_width="match_parent"
      android:layout_height="200dp"
      app:autoSizeTextType="uniform"
      app:autoSizeMinTextSize="12sp"
      app:autoSizeMaxTextSize="100sp"
      app:autoSizeStepGranularity="2sp" />

</LinearLayout>

预设大小

预设大小允许您指定 TextView 在自动调整文本大小时选择的价值观。

• 要以预设大小以编程方式设置 TextView 的自动调整大小，请调用 setAutoSizeTextTypeUniformWithPresetSizes(int[] presetSizes, int unit) 方法。提供一个大小数组和任何 TypedValue 尺寸单位。
• 要以预设大小在 XML 中设置 TextView 的自动调整大小，请使用 android 命名空间并设置以下属性
  • 将 autoSizeTextType 属性设置为 none 或 uniform。 none 值是默认值，而 uniform 允许 TextView 在水平和垂直轴上统一缩放。
  • 将 autoSizePresetSizes 属性设置为预设大小的数组。要将数组作为资源访问，请在 res/values/arrays.xml 文件中定义该数组。

<resources>
  <array name="autosize_text_sizes">
    <item>10sp</item>
    <item>12sp</item>
    <item>20sp</item>
    <item>40sp</item>
    <item>100sp</item>
  </array>
</resources>

<?xml version="1.0" encoding="utf-8"?>
<TextView
    android:layout_width="match_parent"
    android:layout_height="200dp"
    android:autoSizeTextType="uniform"
    android:autoSizePresetSizes="@array/autosize_text_sizes" />

使用 Support Library 设置预设大小

• 要以预设大小通过 Support Library 以编程方式设置 TextView 的自动调整大小，请调用 TextViewCompat.setAutoSizeTextTypeUniformWithPresetSizes(TextView textView, int[] presetSizes, int unit) 方法。提供一个 TextView 类实例、一个大小数组和任何 TypedValue 尺寸单位。
• 要以预设大小通过 Support Library 在 XML 中设置 TextView 的自动调整大小，请使用 app 命名空间并在布局 XML 文件中设置 autoSizeTextType 和 autoSizePresetSizes 属性。

<resources>
  <array name="autosize_text_sizes">
    <item>10sp</item>
    <item>12sp</item>
    <item>20sp</item>
    <item>40sp</item>
    <item>100sp</item>
  </array>
</resources>

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <TextView
      android:layout_width="match_parent"
      android:layout_height="200dp"
      app:autoSizeTextType="uniform"
      app:autoSizePresetSizes="@array/autosize_text_sizes" />
</LinearLayout>

其他资源

有关在处理动态内容时自动调整 TextView 大小的更多信息，请观看 Android Jetpack：自动调整 TextView 大小。