【Android】TextViewのテキストを境界内に自動フィットさせるベストな方法｜AutofitTextViewの使い方

Androidアプリ開発では、画面幅やテキストの長さに応じてTextViewの文字サイズを自動調整したい場面がよくあります。本記事では、定番ライブラリ「AutofitTextView」を利用して、テキストを指定した境界内にぴったり収まるよう自動スケーリングする方法を、手順を追ってわかりやすく解説します。

ステップ1：プロジェクトの作成と依存関係の追加

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File → New Project」を選択し、必要事項を入力してプロジェクトを作成してください。

続いて、build.gradle（Module: App）に以下の依存関係を追加します。

implementation 'com.android.support:design:28.0.0'
implementation 'me.grantland:autofittextview:0.2.1'

ステップ2：レイアウトファイル（activity_main.xml）の編集

res/layout/activity_main.xml に以下のコードを記述します。AutofitTextViewのポイントは、autofit:minTextSize 属性で縮小時の最小フォントサイズを指定できる点です。テキストが長くなると、この最小サイズまで自動的に縮小されます。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:autofit="https://schemas.android.com/apk/res-auto"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <me.grantland.widget.AutofitTextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="2"
        android:singleLine="true"
        android:text="Android AutoFit TextView Example"
        android:textSize="42sp"
        autofit:minTextSize="5sp" />

    <me.grantland.widget.AutofitTextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="2"
        android:layout_marginTop="10dp"
        android:layout_marginBottom="10dp"
        android:singleLine="true"
        android:text="A TextView that automatically reSizes text to fit perfectly within the bounds"
        android:textSize="42sp"
        autofit:minTextSize="5sp" />

    <me.grantland.widget.AutofitTextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="2"
        android:singleLine="true"
        android:text="Android AutoFit TextView"
        android:textSize="42sp"
        autofit:minTextSize="5sp" />

    <me.grantland.widget.AutofitTextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="2"
        android:layout_marginTop="10dp"
        android:layout_marginBottom="10dp"
        android:singleLine="true"
        android:text="Automatically Resized text"
        android:textSize="42sp"
        autofit:minTextSize="5sp" />

    <me.grantland.widget.AutofitTextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="2"
        android:singleLine="true"
        android:text="Automatically Resize Text to Fit Perfectly within its Bounds"
        android:textSize="42sp"
        autofit:minTextSize="5sp" />

</LinearLayout>

ステップ3：MainActivity.java の実装

src/MainActivity.java には、以下のように通常のActivityコードを記述するだけです。特別な処理は不要で、レイアウトを読み込むだけで自動スケーリングが有効になります。

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

ステップ4：AndroidManifest.xml の設定

androidManifest.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それではアプリを実行してみましょう。ここでは、実機のAndroid端末をPCに接続しているものとします。Android Studioでプロジェクト内の任意のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。表示された候補から接続中のモバイル端末を選択して実行すると、端末上に以下のような画面が表示されます。

補足：API 26以降なら標準機能でも自動調整が可能

なお、Android 8.0（APIレベル26）以降では、標準のTextView自体に自動サイズ調整機能が組み込まれています。android:autoSizeTextType="uniform" や android:autoSizeMinTextSize / android:autoSizeMaxTextSize を指定するだけで、外部ライブラリなしで同様の効果が得られます。minSdkVersionが26以上の新規プロジェクトではこちらの標準機能を検討し、古いOSバージョンもサポートする必要がある場合には、本記事で紹介したAutofitTextViewライブラリを活用するとよいでしょう。