【Android Kotlin】InputFilterを使ってEditTextの入力文字数を制限する方法

この記事では、Androidアプリ開発においてInputFilterを使用し、EditTextに入力できる文字数を制限する方法を、Kotlinのコード例とともにわかりやすく解説します。ユーザー名やコメント欄など、入力文字数に上限を設けたい場面で役立つテクニックです。

InputFilterとは？

InputFilterは、EditTextなどのテキスト入力フィールドに対して入力内容をフィルタリングする仕組みです。最大文字数の制限だけでなく、特定の文字種のみ許可するといったカスタマイズも可能です。ここでは最もよく使われる「LengthFilter」による文字数制限を実装します。

実装手順

ステップ1：新規プロジェクトを作成する

Android Studioを開き、「File」→「New Project」を選択して、必要な情報を入力し新しいプロジェクトを作成します。テンプレートは「Empty Activity」で問題ありません。

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

res/layout/activity_main.xml に以下のコードを追加します。画面中央上にEditTextを配置するシンプルなレイアウトです。

<?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:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/editText"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="40dp" />

</RelativeLayout>

ステップ3：MainActivity.ktにInputFilterを実装する

src/MainActivity.kt に以下のコードを記述します。filtersプロパティにLengthFilter(15)を設定することで、EditTextへの入力が15文字までに制限されます。

import android.os.Bundle
import android.text.InputFilter
import android.text.InputFilter.LengthFilter
import android.widget.EditText
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    lateinit var editText: EditText

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"

        editText = findViewById(R.id.editText)

        // 最大文字数を15文字に設定
        val maxTextLength = 15
        editText.filters = arrayOf<InputFilter>(LengthFilter(maxTextLength))

        Toast.makeText(this, "EditText limit set to 15 characters", Toast.LENGTH_SHORT).show()
    }
}

ステップ4：AndroidManifest.xmlを確認する

androidManifest.xml は以下のようになります。特別な権限は不要ですが、アクティビティの登録を確認しておきましょう。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.q11">

    <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（実行）」アイコン をクリックします。表示された選択肢から接続済みのモバイルデバイスを選択すると、実機の画面にアプリが起動します。

EditTextをタップして文字を入力すると、15文字を超えて入力できないことが確認できます。アプリ起動時にはToastで「EditText limit set to 15 characters」というメッセージが表示されます。

まとめ

InputFilterのLengthFilterを使えば、わずか数行のコードでEditTextの入力文字数を制限できます。XMLレイアウト側でandroid:maxLength="15"を指定する方法もありますが、コードから動的に制限値を変更したい場合や、複数のフィルターを組み合わせたい場合は、今回のようにfiltersプロパティを活用するのがおすすめです。