【Android】スクロール可能なTextViewを作成する方法をわかりやすく解説

はじめに

この記事では、Androidアプリでスクロール可能なTextViewを作成する方法を、サンプルコード付きで順を追って解説します。長い文章を画面内に収めて表示したい場合に役立つテクニックなので、ぜひ参考にしてください。

実装のポイント

スクロール可能なTextViewを実現するには、次の2点が重要です。

• レイアウトXMLで android:scrollbars="vertical" を指定する
• Javaコード側で setMovementMethod(new ScrollingMovementMethod()) を呼び出す

この2つを組み合わせることで、テキストが画面からはみ出したときに縦方向へスクロールできるようになります。

実装手順

ステップ1：新規プロジェクトの作成

Android Studioを起動し、「File」⇒「New Project」を選択して新しいプロジェクトを作成します。必要な項目を入力してプロジェクトの雛形を生成しましょう。

ステップ2：activity_main.xml の編集

res/layout/activity_main.xml に以下のコードを追加します。TextViewに android:scrollbars="vertical" を指定している点に注目してください。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="5dp"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:scrollbars="vertical" />

</RelativeLayout>

ステップ3：MainActivity.java の編集

src/MainActivity.java に以下のコードを追加します。長いテキストをTextViewにセットし、ScrollingMovementMethod を設定することでスクロールを有効化しています。

package app.com.sample;

import android.os.Bundle;
import android.text.method.ScrollingMovementMethod;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView textView = findViewById(R.id.textView);

        String para = "Mohandas Karamchand Gandhi (1869\u20131948) was an Indian activist who led "
                + "the Indian independence movement against British colonial rule. Employing "
                + "nonviolent civil disobedience, he inspired movements for civil rights and "
                + "freedom across the world.\n\n"
                + "Trained as a lawyer in London, Gandhi first employed nonviolent civil "
                + "disobedience in South Africa. After returning to India in 1915, he organised "
                + "protests against excessive land-tax and discrimination, later leading the "
                + "Dandi Salt March in 1930 and the Quit India movement in 1942. He was "
                + "assassinated on 30 January 1948.";

        textView.setText(para);
        textView.setMovementMethod(new ScrollingMovementMethod());
    }
}

補足：古いサンプルでは android.support.v7.app.AppCompatActivity が使われていますが、現在は非推奨のため、上記のように androidx.appcompat.app.AppCompatActivity への移行をおすすめします。

ステップ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端末をパソコンに接続しておいてください。Android Studioから実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの実行（Run）アイコンをクリックします。接続済みのモバイルデバイスを選択すると、端末にアプリが起動し、長いテキストが縦方向にスクロールできる状態で表示されます。

まとめ

スクロール可能なTextViewは、android:scrollbars="vertical" 属性と ScrollingMovementMethod の設定だけで簡単に実装できます。利用規約や長い説明文などを表示する際に便利なので、ぜひ自分のプロジェクトでも活用してみてください。