EditText: 개념, 속성 및 Android에서 입력 필드 작업하기

Android에서 EditText란

EditText는 android.widget 패키지의 클래스로, 사용자 데이터 입력을 위한 대화형 텍스트 필드를 구현합니다. Android 상속 계층 구조에서 EditText는 TextView를 확장하므로 글꼴, 색상 및 정렬 관리를 포함한 텍스트 레이블의 모든 속성을 상속합니다. EditText와 TextView의 주요 차이점은 콘텐츠 편집 기능입니다 — 사용자는 인터페이스에서 직접 텍스트를 입력, 삭제 및 수정할 수 있습니다.

각 EditText는 입력된 텍스트를 저장하고 삽입, 삭제 및 바꾸기 작업을 지원하는 Editable 인스턴스와 연결됩니다. 입력 시 EditText는 자동으로 커서 위치, 텍스트 선택 및 실행 취소/다시 실행을 위한 변경 기록을 관리합니다. Android Developers Guide (2026)에 따르면, EditText는 EditText를 상속하는 AutoCompleteTextView 클래스를 통해 자동 완성도 지원합니다.

EditText의 아키텍처는 모델(Editable), 뷰(TextView) 및 컨트롤러(InputConnection)의 분리를 기반으로 합니다. 포커스를 얻으면 EditText는 InputConnection을 생성하고, 이를 통해 입력 시스템이 문자, 키 누름 및 편집 명령을 전달합니다. 이 메커니즘은 가상 키보드에서 물리적 Bluetooth 키보드 및 음성 입력에 이르기까지 모든 입력 방식과의 호환성을 보장합니다.

val editText = EditText(context).apply {
    hint = "텍스트 입력"
    inputType = InputType.TYPE_CLASS_TEXT
    maxLines = 1
    setTextColor(Color.parseColor("#000000"))
}

EditText의 주요 속성

EditText는 동작과 모양을 미세 조정하기 위한 수십 개의 속성을 제공합니다. 이러한 속성은 XML 레이아웃과 Kotlin 또는 Java를 통한 프로그래밍 방식 모두에서 설정할 수 있습니다. 속성은 텍스트 제어, 제약 조건, 시각적 스타일링 및 키보드 상호 작용의 범주로 나뉩니다.

android:hint 속성은 가장 중요한 속성 중 하나입니다 — 필드에 어떤 데이터가 필요한지 사용자에게 알려줍니다. 텍스트가 입력되면 힌트가 자동으로 숨겨집니다. 힌트는 폼 제출에 참여하지 않으며 필드 값으로 저장되지 않습니다. Material Design은 보다 현대적인 외관을 위해 일반 힌트 대신 플로팅 레이블이 있는 TextInputLayout을 사용할 것을 권장합니다.

• android:selectAllOnFocus — 포커스를 받으면 모든 텍스트를 선택합니다(검색 필드에 유용).
• android:maxLength — 입력 문자 수를 제한하고 초과분을 자릅니다.
• android:lines — 필드 높이를 줄 단위로 고정 설정합니다(minLines와 반대).
• android:gravity — 필드 내 텍스트 정렬: left, center, top 등.

                <!-- EditText in XML layout -->
@+id/etEmail
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="Enter email"
android:inputType="textEmailAddress"
android:maxLines="1"
android:importantForAutofill="yes" />

입력 모드 및 inputType

inputType 속성은 사용자에게 표시될 키보드 유형과 입력에 허용되는 문자를 결정합니다. 입력 클래스(TYPE_CLASS_TEXT, TYPE_CLASS_NUMBER, TYPE_CLASS_PHONE)가 수정자와 결합되는 비트 마스크입니다.

각 입력 모드는 키보드 레이아웃을 변경할 뿐만 아니라 텍스트 처리에도 영향을 줍니다. 숫자 모드에서는 숫자와 소수 구분 기호만 허용되고, 이메일 모드에서는 @ 기호와 도메인 확장자를 사용할 수 있으며, 전화 모드에서는 숫자와 +, #, * 기호가 표시됩니다. 올바른 inputType 선택은 사용자 경험에 큰 영향을 미칩니다 — 부적절한 키보드는 사용자가 모드를 전환하도록 강제하여 폼 작성 시간을 30~50% 증가시킵니다.

Material Design Guidelines (2025)에 따르면 각 필드에 가장 구체적인 inputType을 사용하는 것이 좋습니다: 비밀번호에는 textPassword, 가격에는 numberDecimal, 전화번호에는 phone, 여러 줄 입력에는 textMultiLine. 이렇게 하면 폼 작성 속도가 빨라지고 입력 오류가 줄어듭니다.

// 프로그래밍 방식 inputType 설정
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_AUTO_CORRECT

EditText 리스너: TextWatcher 및 OnEditorActionListener

TextWatcher는 EditText에서 텍스트 변경을 실시간으로 추적하기 위한 인터페이스입니다. 세 가지 메서드가 포함되어 있습니다. beforeTextChanged는 변경 전에 호출되고, onTextChanged는 변경 중에 호출되고, afterTextChanged는 텍스트 변경 완료 후에 호출됩니다. TextWatcher는 입력 검증, 문자 수 계산, 검색 및 자동 완성에 사용됩니다.

OnEditorActionListener는 키보드에서 사용자 작업을 처리합니다: Done(IME_ACTION_DONE), Search(IME_ACTION_SEARCH), Send(IME_ACTION_SEND), Next(IME_ACTION_NEXT) 등을 누릅니다. 이 리스너는 폼 탐색을 구성하는 데 특히 유용합니다 — Next를 누르면 자동으로 다음 필드로 포커스가 이동하고, Done을 누르면 키보드가 숨겨지고 제출이 수행됩니다.

Android Developers Blog (2025)에 따르면, android:imeOptions 속성과 함께 OnEditorActionListener를 적절히 사용하면 추가 제출 버튼 없이 직관적인 폼을 만들 수 있습니다 — 사용자가 필드를 작성하고 키보드에서 Done을 누르면 저장이나 검색이 트리거됩니다.

// 이메일 검증용 TextWatcher
editText.addTextChangedListener(object : TextWatcher {
    override fun afterTextChanged(s: Editable?) {
        val isValid = Patterns.EMAIL_ADDRESS.matcher(s).matches()
        editText.error = if (isValid) null else "Invalid email format"
    }
})

// 폼 제출용 OnEditorActionListener
editText.setOnEditorActionListener { _, actionId, _ ->
    if (actionId == EditorInfo.IME_ACTION_DONE) {
        submitForm()
        true
    } else false
}

EditText 코드 예제

이메일 및 비밀번호 입력을 위해 EditText를 사용하여 로그인 화면을 만드는 완전한 예제를 살펴보겠습니다. 이 예제는 inputType 구성, TextWatcher를 통한 검증 및 로그인 버튼 누름 처리를 보여줍니다.

로그인 화면 XML 레이아웃

@+id/etLoginEmail
android:layout_width="match_parent"
android:hint="Email"
android:inputType="textEmailAddress"
android:maxLines="1" />

@+id/etLoginPassword
android:layout_width="match_parent"
android:hint="Password"
android:inputType="textPassword"
android:maxLines="1" />

EditText 프로그래밍 방식 설정

class LoginFragment : Fragment() {
    private lateinit var etEmail: EditText
    private lateinit var etPassword: EditText

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        etEmail = view.findViewById(R.id.etLoginEmail)
        etPassword = view.findViewById(R.id.etLoginPassword)

        etEmail.addTextChangedListener(emailWatcher)
        etPassword.setOnEditorActionListener { _, actionId, _ ->
            if (actionId == EditorInfo.IME_ACTION_DONE) {
                performLogin()
                true
            } else false
        }
    }
}

EditText 스타일링

EditText는 XML 속성, 테마 및 스타일을 통한 사용자 지정을 지원합니다. 텍스트 색상, 힌트 색상, 밑줄 색상(backgroundTint), 글꼴 스타일, 텍스트 크기 등을 변경할 수 있습니다. Material Components는 boxStrokeColor, boxBackgroundColor 및 endIconMode를 포함한 사용자 지정 속성이 있는 MaterialComponents.EditText 테마를 제공합니다.

EditText의 밑줄 색상을 변경하려면 android:backgroundTint 속성을 사용합니다. 이 속성은 기본 상태와 포커스 상태의 색상을 설정합니다. Material Design에서 밑줄 색상은 테마의 colorPrimary를 통해 관리됩니다. 완전한 사용자 지정을 위해 res/drawable 폴더에 배경용 사용자 지정 drawable을 만들 수 있습니다.

앱의 모든 EditText 필드에 일관된 스타일을 만들려면 테마에 전역 스타일을 정의하는 것이 좋습니다. Material Design은 TextInputLayout을 사용하는 모든 입력 필드에 자동으로 적용되는 Widget.MaterialComponents.TextInputLayout.OutlinedBox 스타일을 제공합니다. 이렇게 하면 각 레이아웃에서 속성을 중복하지 않고 일관된 외관을 보장합니다.