AutoCompleteTextView란 무엇인가?
예제를 살펴보기 전에 안드로이드의 자동 완성 텍스트 뷰(AutoCompleteTextView)가 무엇인지 먼저 알아보겠습니다. AutoCompleteTextView는 일반 EditText와 비슷한 위젯으로, EditText의 하위 클래스입니다. 다만 사용자가 입력하는 글자에 따라 목록 형태의 제안 사항을 드롭다운 메뉴로 보여주는 기능이 추가되어 있습니다.
AutoCompleteTextView를 사용하려면 임계값(Threshold)을 설정해야 합니다. 예를 들어 임계값을 1로 설정하면, 사용자가 한 글자만 입력해도 해당 글자에 맞는 제안 목록이 즉시 표시됩니다.
이번 예제에서는 AutoCompleteTextView에 어댑터(Adapter)를 설정하는 방법을 단계별로 알아보겠습니다.
1단계 — 새 프로젝트 생성
Android Studio에서 File ⇒ New Project를 선택하고, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계 — 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:app="https://schemas.android.com/apk/res-auto"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:orientation="vertical"
tools:context=".MainActivity">
<AutoCompleteTextView
android:id="@+id/autoComplete"
android:layout_width="fill_parent"
android:hint="Enter programming language"
android:layout_height="wrap_content" />
</LinearLayout>
위 코드에서는 AutoCompleteTextView 하나를 선언했습니다. 사용자가 글자를 입력하면 해당 글자에 맞는 제안 목록이 드롭다운 메뉴 형태로 화면에 나타납니다.
3단계 — MainActivity 작성
src/MainActivity.java 파일에 아래 코드를 추가합니다.
package com.example.andy.myapplication;
import android.os.Bundle;
import android.text.Editable;
import android.text.TextWatcher;
import android.util.Log;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import androidx.appcompat.app.AppCompatActivity;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
final AutoCompleteTextView autoCompleteTextView = findViewById(R.id.autoComplete);
ArrayList<String> arrayList = new ArrayList<>();
arrayList.add("Android");
arrayList.add("JAVA");
arrayList.add("CPP");
arrayList.add("C Programming");
arrayList.add("Kotlin");
arrayList.add("CSS");
arrayList.add("HTML");
arrayList.add("PHP");
arrayList.add("Swift");
ArrayAdapter arrayAdapter = new ArrayAdapter(this,
android.R.layout.simple_dropdown_item_1line, arrayList);
autoCompleteTextView.setAdapter(arrayAdapter);
autoCompleteTextView.setThreshold(1);
autoCompleteTextView.addTextChangedListener(new TextWatcher() {
@Override
public void beforeTextChanged(CharSequence s, int start,
int count, int after) {
Log.d("beforeTextChanged", String.valueOf(s));
}
@Override
public void onTextChanged(CharSequence s, int start,
int before, int count) {
Log.d("onTextChanged", String.valueOf(s));
}
@Override
public void afterTextChanged(Editable s) {
Log.d("afterTextChanged", String.valueOf(s));
}
});
}
}
코드 설명
위 코드에서는 프로그래밍 언어 이름들을 ArrayList에 저장하고, 이 리스트를 ArrayAdapter에 연결했습니다. 그런 다음 setAdapter() 메서드를 통해 어댑터를 AutoCompleteTextView에 설정하고, setThreshold(1)로 임계값을 1로 지정했습니다. 또한 TextWatcher를 등록하여 입력 내용이 변경될 때마다 로그를 기록하도록 했습니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 후, 툴바에서 Run 아이콘을 클릭하세요. 실행할 기기로 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
처음에는 위와 같은 빈 화면이 나타납니다. 이 상태에서 텍스트 뷰에 "ja"를 입력하면 어댑터에 저장된 데이터 중 일치하는 항목이 아래와 같이 제안됩니다.
위 결과에서는 "JAVA"라는 제안 항목 하나만 표시됩니다. 이번에는 입력한 J를 지우고 "c"를 입력해 보세요. 그러면 C로 시작하는 여러 개의 제안 항목이 아래와 같이 동시에 표시되는 것을 확인할 수 있습니다.
이처럼 AutoCompleteTextView에 ArrayAdapter를 설정하면, 사용자가 입력한 글자에 따라 실시간으로 검색 제안 목록을 손쉽게 구현할 수 있습니다.