Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드 ListView 내부에 포커스 가능한 EditText 만드는 방법

이 튜토리얼에서는 안드로이드 앱에서 ListView 내부에 포커스(focus)를 받을 수 있는 EditText를 구현하는 방법을 단계별로 살펴봅니다. ListView의 각 항목에 EditText를 배치하면 사용자가 목록 항목을 직접 편집할 수 있어, 입력 폼이나 메모 목록 등 다양한 UI에서 활용도가 매우 높습니다.

핵심 개념 정리

ListView 안에 EditText처럼 포커스를 받는 뷰를 넣으려면 다음 두 가지 설정이 반드시 필요합니다.

  • setItemsCanFocus(true) — 리스트 항목 자체가 포커스를 가질 수 있도록 허용합니다.
  • android:descendantFocusability="beforeDescendants" — ListView가 자식 뷰들보다 먼저 포커스를 처리하도록 지정합니다.

1단계 — 새 프로젝트 생성

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

2단계 — activity_main.xml 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?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:orientation="vertical"
    android:padding="4dp"
    tools:context=".MainActivity">
    <ListView
        android:id="@+id/listView"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:descendantFocusability="beforeDescendants">
    </ListView>
</LinearLayout>

3단계 — 리스트 항목 레이아웃 생성

새 레이아웃 리소스 파일(예: res/layout/listitem.xml)을 만들고 아래 코드를 추가합니다. 각 리스트 항목은 하나의 EditText로 구성됩니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    <EditText
        android:id="@+id/ItemCaption"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_marginStart="2dip"
        android:singleLine="true">
    </EditText>
</LinearLayout>

4단계 — MainActivity.java 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다.

import androidx.appcompat.app.AppCompatActivity;
import android.annotation.SuppressLint;
import android.app.LauncherActivity;
import android.content.Context;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.EditText;
import android.widget.ListView;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {
    ListView listView;
    MyAdapter myAdapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = findViewById(R.id.listView);
        listView.setItemsCanFocus(true);
        myAdapter = new MyAdapter();
        listView.setAdapter(myAdapter);
    }

    private class MyAdapter extends BaseAdapter {
        private LayoutInflater layoutInflater;
        ArrayList<LauncherActivity.ListItem> myItems = new ArrayList<>();

        MyAdapter() {
            layoutInflater = (LayoutInflater) getSystemService(Context.LAYOUT_INFLATER_SERVICE);
            for (int i = 0; i < 7; i++) {
                LauncherActivity.ListItem listItem = new LauncherActivity.ListItem();
                listItem.className = "Caption" + i;
                myItems.add(listItem);
            }
            notifyDataSetChanged();
        }

        @Override
        public int getCount() {
            return myItems.size();
        }

        @Override
        public Object getItem(int position) {
            return position;
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @SuppressLint("InflateParams")
        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            ViewHolder holder;
            if (convertView == null) {
                holder = new ViewHolder();
                convertView = layoutInflater.inflate(R.layout.listitem, null);
                holder.caption = convertView.findViewById(R.id.ItemCaption);
                convertView.setTag(holder);
            } else {
                holder = (ViewHolder) convertView.getTag();
            }
            holder.caption.setText(myItems.get(position).className);
            holder.caption.setId(position);
            holder.caption.setOnFocusChangeListener(new View.OnFocusChangeListener() {
                public void onFocusChange(View v, boolean hasFocus) {
                    if (!hasFocus) {
                        final int position = v.getId();
                        final EditText Caption = (EditText) v;
                        myItems.get(position).className = Caption.getText().toString();
                    }
                }
            });
            return convertView;
        }
    }

    class ViewHolder {
        EditText caption;
    }
}

코드 동작 원리

  • MyAdapter — BaseAdapter를 상속하여 7개의 ListItem을 생성하고 ListView에 바인딩합니다.
  • ViewHolder 패턴 — convertView를 재사용하여 스크롤 성능을 최적화합니다.
  • setId(position) — 포커스 변경 시 어떤 항목인지 식별할 수 있도록 위치 값을 ID로 설정합니다.
  • OnFocusChangeListener — EditText가 포커스를 잃는 순간 입력된 텍스트를 데이터(ArrayList)에 저장합니다. 덕분에 스크롤로 뷰가 재활용되더라도 사용자가 입력한 값이 그대로 유지됩니다.

5단계 — AndroidManifest.xml 수정

AndroidManifest.xml 파일에 아래 코드를 추가합니다. 특히 android:windowSoftInputMode="adjustPan" 속성은 소프트 키보드가 올라올 때 화면이 자동으로 조정되어 EditText가 키보드에 가려지지 않도록 해주는 중요한 설정입니다.

<?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" android:windowSoftInputMode="adjustPan">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run ▶ 아이콘을 클릭하세요. 실행 대상으로 모바일 기기를 선택하면 연결된 기기 화면에 앱이 표시됩니다.

안드로이드 ListView 내부에 포커스 가능한 EditText 만드는 방법

앱이 정상적으로 실행되면 ListView에 7개의 EditText 항목이 나타나고, 각 항목을 탭하면 텍스트를 자유롭게 편집할 수 있습니다. 다른 항목으로 포커스를 옮기면 입력한 값이 저장되어 스크롤 후에도 유지되는 것을 확인할 수 있습니다.

안드로이드 ListView 내부에 포커스 가능한 EditText 만드는 방법