このページは Cloud Translation API によって翻訳されました。

TextView の自動サイズ調整

Android 8.0（API レベル 26）以降では、 TextView: テキストサイズを調整しますサイズに応じて、レイアウトに合わせて自動的に拡大または縮小 TextView の特性と境界。この設定により、動的コンテンツを使用して、さまざまな画面でテキストサイズを最適化します。

サポートライブラリ 26.0 が TextView の自動サイズ設定を完全にサポートこの機能は、Android バージョン 8.0（API レベル 26）以前を搭載しているデバイスで利用できます。 android.support.v4.widget パッケージには、TextViewCompat が含まれています。下位互換性のある方法で機能にアクセスできます。

TextView の自動サイズ調整を設定する

フレームワークまたはサポートライブラリを使用して、 TextView。プログラムまたは XML で記述します。XML 属性を設定するには、Android Studio の [Properties] ウィンドウも利用できます。

TextView の自動サイズ調整を設定する方法は 3 つあります。以降のセクションで説明します。

デフォルト
粒度
プリセットサイズ

注: XML ファイルで自動サイズ設定を設定した場合、値「wrap_content」を使用することをおすすめします。の属性の layout_width 属性または layout_height 属性 TextView。その結果、想定外の結果になることもあります

デフォルト

デフォルトの設定では、TextView の自動サイズ調整が有効になります。水平軸と垂直軸で一様に表示します。

デフォルトの設定をプログラムで定義するには、 <ph type="x-smartling-placeholder"></ph> 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" />

サポートライブラリを使用してデフォルト設定を定義する

サポートライブラリからプログラムでデフォルト設定を定義するには、次の操作を行います。呼び出す <ph type="x-smartling-placeholder"></ph> 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 を使用します。 Namespace と次の属性があります。 <ph type="x-smartling-placeholder">
- 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" />

サポートライブラリを使用して粒度を定義する

テキストサイズの範囲とディメンションをサポートライブラリを使用する場合は、 <ph type="x-smartling-placeholder"></ph> TextViewCompat.setAutoSizeTextTypeUniformWithConfiguration(int autoSizeMinTextSize, int autoSizeMaxTextSize, int autoSizeStepGranularity, int unit) メソッドを呼び出します。最大値、最小値、粒度値、および任意の TypedValue ディメンション単位。
Support API を使用して、XML でテキストサイズの範囲とディメンションを定義するには、ライブラリでは、app 名前空間を使用し、 autoSizeText、autoSizeMinTextSize、 autoSizeMaxTextSize、およびレイアウト XML ファイル内の 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" />

サポートライブラリを使用してプリセットサイズを設定する

プリセットサイズを使用して、プログラムによる TextView サポートライブラリを使用する場合は、 <ph type="x-smartling-placeholder"></ph> TextViewCompat.setAutoSizeTextTypeUniformWithPresetSizes(TextView textView, int[] presetSizes, int unit) メソッドを呼び出します。TextView クラスのインスタンス、サイズの配列と、任意の TypedValue ディメンション単位が指定します。
プリセットサイズを使用して、サポートライブラリを介して XML で TextView を使用する場合は、 app 名前空間を使用し、autoSizeTextType とレイアウト XML ファイル内の 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 の自動サイズ調整。

TextView の自動サイズ調整 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

TextView の自動サイズ調整を設定する

デフォルト

サポート ライブラリを使用してデフォルト設定を定義する

粒度

サポート ライブラリを使用して粒度を定義する

プリセット サイズ

サポート ライブラリを使用してプリセット サイズを設定する