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

안드로이드 RecyclerView GridLayoutManager 열 간격(Spacing) 설정하는 완벽 가이드

이 튜토리얼에서는 안드로이드 RecyclerView의 GridLayoutManager에서 열 간격(column spacing)을 설정하는 방법을 단계별로 알아봅니다. 그리드 형태의 목록에서 항목 사이에 적절한 여백을 주면 UI가 훨씬 깔끔하고 전문적으로 보입니다.

핵심 원리: ItemDecoration 활용하기

RecyclerView에서 항목 간 간격을 조절하는 가장 표준적인 방법은 RecyclerView.ItemDecoration 클래스를 상속받아 getItemOffsets() 메서드를 오버라이드하는 것입니다. 이를 통해 각 항목 주변에 원하는 크기의 여백을 지정할 수 있습니다.

Step 1 — 새 프로젝트 생성

Android Studio에서 File ⇒ New Project로 이동하여 새 프로젝트를 생성하고, 필요한 모든 세부 정보를 입력합니다.

Step 2 — activity_main.xml 레이아웃 작성

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

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.design.widget.CoordinatorLayout android:layout_width = "match_parent"
   android:layout_height = "match_parent"
   xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:app = "https://schemas.android.com/apk/res-auto">
   <android.support.design.widget.AppBarLayout
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content">
      <android.support.v7.widget.Toolbar
         android:id = "@+id/appbarlayout_tool_bar"
         android:background = "@color/colorPrimary"
         android:layout_width = "match_parent"
         android:layout_height = "?attr/actionBarSize"
         app:layout_scrollFlags = "scroll|snap|enterAlways"
         app:theme = "@style/ThemeOverlay.AppCompat.Dark.ActionBar"
         app:popupTheme = "@style/ThemeOverlay.AppCompat.Light" />
   </android.support.design.widget.AppBarLayout>
   <android.support.v7.widget.RecyclerView
      android:id = "@+id/recycler_view"
      android:layout_width = "match_parent"
      android:layout_height = "match_parent"
      app:layout_behavior = "@string/appbar_scrolling_view_behavior"/>
</android.support.design.widget.CoordinatorLayout>

위 코드에서는 CoordinatorLayout 안에 Toolbar와 RecyclerView를 배치했습니다. AppBarLayout과 함께 사용하면 스크롤 시 툴바가 자연스럽게 반응합니다.

Step 3 — MainActivity.java 작성

다음 코드를 src/MainActivity.java 파일에 추가합니다. 여기서 GridLayoutManager로 2열 그리드를 구성하고, SpacesItemDecoration을 통해 간격을 적용합니다.

package com.example.myapplication;
import android.annotation.TargetApi;
import android.os.Build;
import android.os.Bundle;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.DefaultItemAnimator;
import android.support.v7.widget.DividerItemDecoration;
import android.support.v7.widget.GridLayoutManager;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.support.v7.widget.Toolbar;
import android.widget.TextView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
   TextView text;
   ArrayList<String> list = new ArrayList<>();
   private RecyclerView recyclerView;
   private customAdapter mAdapter;
   private onClickInterface onclickInterface;
   @TargetApi(Build.VERSION_CODES.LOLLIPOP)
   @Override
   public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      Toolbar toolbar = (android.support.v7.widget.Toolbar) findViewById(R.id.appbarlayout_tool_bar);
      toolbar.setTitle("This is toolbar.");
      setSupportActionBar(toolbar);
      onclickInterface = new onClickInterface() {
         @Override
         public void setClick(int abc) {
            list.remove(abc);
            Toast.makeText(MainActivity.this,"Position is"+abc,Toast.LENGTH_LONG).show();
            mAdapter.notifyDataSetChanged();
         }
      };
      recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
      GridLayoutManager mLayoutManager = new GridLayoutManager(getApplicationContext(),2);
      recyclerView.setLayoutManager(mLayoutManager);
      recyclerView.setItemAnimator(new DefaultItemAnimator());
      mAdapter = new customAdapter(this, list, onclickInterface);
      recyclerView.setAdapter(mAdapter);
      recyclerView.addItemDecoration(new SpacesItemDecoration(10));
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
      list.add("Krishna");
      list.add("prasad");
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
      list.add("sairamm");
      list.add("Krishna");
      list.add("prasad");
   }
}

핵심 부분은 다음 두 줄입니다:

  • new GridLayoutManager(getApplicationContext(), 2) — 2열 그리드 레이아웃 생성
  • recyclerView.addItemDecoration(new SpacesItemDecoration(10)) — 항목 사이에 10dp 간격 추가

Step 4 — customAdapter.java 작성

다음 코드를 src/customAdapter.java 파일에 추가합니다.

package com.example.myapplication;
import android.content.Context;
import android.support.annotation.NonNull;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import java.util.ArrayList;
public class customAdapter extends RecyclerView.Adapter<customAdapter.MyViewHolder> {
   Context context;
   ArrayList<String> list;
   onClickInterface onClickInterface;
   public class MyViewHolder extends RecyclerView.ViewHolder {
      public TextView title;
      public MyViewHolder(View view) {
         super(view);
         title = (TextView) view.findViewById(R.id.title);
      }
   }
   public customAdapter(Context context, ArrayList<String> list, onClickInterface onClickInterface) {
      this.context = context;
      this.list = list;
      this.onClickInterface = onClickInterface;
   }
   @NonNull
   @Override
   public MyViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
      View itemView = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.list_row, viewGroup, false);
      return new MyViewHolder(itemView);
   }
   @Override
   public void onBindViewHolder(@NonNull MyViewHolder myViewHolder, final int i) {
      myViewHolder.title.setText(list.get(i));
      myViewHolder.title.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            onClickInterface.setClick(i);
         }
      });
   }
   @Override
   public int getItemCount() {
      return list.size();
   }
}

Step 5 — list_row.xml 아이템 레이아웃 작성

다음 코드를 res/layout/list_row.xml 파일에 추가합니다. CardView를 사용해 각 항목에 그림자와 둥근 모서리 효과를 적용했습니다.

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.v7.widget.CardView 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 = "wrap_content"
   app:cardElevation = "10dp"
   app:cardCornerRadius = "20dp"
   tools:context = ".MainActivity">
   <LinearLayout
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content"
      android:gravity = "center"
      android:orientation = "vertical">
      <ImageView
         android:id = "@+id/imageView2"
         android:layout_width = "wrap_content"
         android:layout_height = "wrap_content"
         android:src = "@drawable/logo" />
      <TextView
         android:id = "@+id/title"
         android:layout_width = "match_parent"
         android:layout_height = "wrap_content"
         android:gravity = "center"
         android:textSize = "30sp" />
      <TextView
         android:id = "@+id/textview2"
         android:layout_width = "match_parent"
         android:layout_height = "wrap_content"
         android:gravity = "center"
         android:text = "Sairamkrishan"
         android:textSize = "30sp" />
   </LinearLayout>
</android.support.v7.widget.CardView>

Step 6 — onClickInterface 정의

다음 코드를 src/onClickInterface.java 파일에 추가합니다. 클릭 이벤트를 액티비티로 전달하기 위한 인터페이스입니다.

package com.example.myapplication;
public interface onClickInterface {
   void setClick(int abc);
}

Step 7 — SpacesItemDecoration으로 간격 구현 (핵심!)

다음 코드를 src/SpacesItemDecoration.java 파일에 추가합니다. 이 클래스가 바로 열 간격을 조절하는 핵심 역할을 담당합니다.

package com.example.myapplication;
import android.graphics.Rect;
import android.support.v7.widget.RecyclerView;
import android.view.View;
public class SpacesItemDecoration extends RecyclerView.ItemDecoration {
   private int space;
   public SpacesItemDecoration(int space) {
      this.space = space;
   }
   @Override
   public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
      outRect.left = space;
      outRect.right = space;
      outRect.bottom = space;
      // 첫 번째 항목에만 상단 여백을 추가하여 항목 간 이중 간격 방지
      if (parent.getChildLayoutPosition(view) == 0) {
         outRect.top = space;
      } else {
         outRect.top = 0;
      }
   }
}

getItemOffsets() 메서드에서 좌우 하단에 각각 space만큼의 여백을 지정하고, 첫 번째 항목에만 상단 여백을 추가해 나머지 항목들 사이에 이중 간격이 생기는 것을 방지합니다.

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 실행 옵션에서 모바일 기기를 선택하세요. 그러면 모바일 기능 화면에 다음과 같이 2열 그리드 형태로 항목들이 일정한 간격을 유지하며 표시됩니다.

안드로이드 RecyclerView GridLayoutManager 열 간격(Spacing) 설정하는 완벽 가이드

참고: AndroidX 프로젝트를 사용하는 경우

위 예제는 구버전 support 라이브러리(android.support.*)를 기준으로 작성되었습니다. 최신 Android Studio에서 AndroidX 프로젝트를 생성했다면 import 문을 다음과 같이 변경해야 합니다.

  • androidx.appcompat.app.AppCompatActivity
  • androidx.recyclerview.widget.RecyclerView, GridLayoutManager, DefaultItemAnimator
  • com.google.android.material.appbar.AppBarLayout
  • androidx.appcompat.widget.Toolbar, CardView

클래스 이름과 동작 방식은 동일하므로 나머지 코드는 그대로 사용할 수 있습니다.