안드로이드에서 InputFilter로 EditText 입력 글자 수 제한하는 방법

이 글에서는 안드로이드 앱 개발 시 InputFilter를 활용해 EditText에 입력할 수 있는 문자 수를 제한하는 방법을 단계별로 소개합니다. 사용자가 너무 긴 텍스트를 입력하지 못하도록 막아야 할 때 유용하게 활용할 수 있는 기능입니다.

InputFilter란 무엇인가?

InputFilter는 EditText에 입력되는 텍스트에 규칙을 적용하는 인터페이스입니다. 그중 InputFilter.LengthFilter를 사용하면 최대 입력 가능한 글자 수를 손쉽게 지정할 수 있습니다. 참고로 XML 레이아웃에서 android:maxLength="15" 속성을 사용하는 방법도 있지만, 코드에서 동적으로 제한을 변경해야 하는 경우에는 InputFilter를 사용하는 것이 더 유연합니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File → New Project 메뉴로 이동한 뒤, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.

2단계: 레이아웃 파일 작성

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에 InputFilter 적용

src/MainActivity.java 파일에 아래 코드를 작성합니다. 여기서는 최대 입력 길이를 15자로 설정했습니다.

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.text.InputFilter;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    EditText editText;

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

        editText = findViewById(R.id.editText);

        int maxTextLength = 15;
        editText.setFilters(new InputFilter[]{new InputFilter.LengthFilter(maxTextLength)});

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

핵심은 다음 한 줄입니다.

editText.setFilters(new InputFilter[]{new InputFilter.LengthFilter(maxTextLength)});

setFilters() 메서드는 배열 형태로 필터를 전달받기 때문에, 필요하다면 여러 개의 InputFilter를 동시에 적용할 수도 있습니다. 예를 들어 대문자만 입력되도록 강제하는 InputFilter.AllCaps와 함께 조합하는 것도 가능합니다.

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(실행) 아이콘을 클릭하세요. 실행 기기 목록에서 본인의 모바일 기기를 선택하면 아래와 같은 화면이 표시됩니다.

EditText에 텍스트를 입력해 보면 15자를 초과하는 부분은 더 이상 입력되지 않는 것을 확인할 수 있습니다. 이처럼 InputFilter를 활용하면 짧은 코드 몇 줄만으로 사용자 입력을 깔끔하게 제어할 수 있습니다.