Android EditText 입력 글자 수 제한하는 방법 – maxLength 속성 활용 가이드

안드로이드 앱을 개발하다 보면 사용자가 너무 긴 텍스트를 입력하지 못하도록 EditText의 글자 수를 제한해야 하는 경우가 자주 발생합니다. 닉네임, 전화번호, 인증 코드 등을 입력받을 때 특히 유용한 기능인데요. 이번 글에서는 maxLength 속성을 활용해 EditText의 입력 길이를 간단하게 제한하는 방법을 단계별로 살펴보겠습니다.

1단계: 새 프로젝트 생성

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

2단계: 레이아웃 XML 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 핵심은 EditText 태그에 android:maxLength="10" 속성을 지정하는 것입니다. 이렇게 하면 사용자는 최대 10자까지만 입력할 수 있습니다.

<?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"
    android:layout_margin="16dp"
    tools:context=".MainActivity">

    <EditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Enter something..."
        android:maxLength="10" />

</LinearLayout>

3단계: MainActivity 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. maxLength 속성은 XML만으로 처리되기 때문에, 자바 코드에는 별도의 로직 없이 기본 onCreate 메서드만 작성하면 됩니다.

package app.tutorialspoint.com.sample;
import android.support.v7.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.tutorialspoint.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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 실행(Run) 아이콘을 클릭하세요. 실행 옵션 목록에서 연결된 모바일 기기를 선택하면, 해당 기기 화면에 앱이 실행됩니다.

아래 이미지와 같이 EditText에 11번째 글자부터는 더 이상 입력되지 않고, 최대 10자까지만 입력되는 것을 확인할 수 있습니다.

추가 팁: 코드로 동적으로 길이 제한하기

XML이 아니라 자바 코드에서 길이 제한을 설정해야 하는 경우에는 InputFilter.LengthFilter를 사용할 수 있습니다. 예를 들어 다음과 같이 작성하면 editText에 최대 10자까지 입력되도록 제한할 수 있습니다.

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

상황에 따라 XML의 maxLength 속성 또는 InputFilter 방식을 선택해 사용하면 되며, 두 방법 모두 동일하게 입력 길이를 제어할 수 있습니다.