【Android開発】RecyclerViewでCardViewを使用する方法をステップごとに解説

この記事では、Androidアプリ開発においてRecyclerViewでCardViewを使用する方法を、ステップごとのサンプルコードとともにわかりやすく解説します。リストの各項目を角丸・影付きのカード形式で表示できるようになり、見た目が洗練されたUIを作成できます。

手順1：新規プロジェクトを作成する

Android Studioを開き、File → New Projectを選択します。必要な項目をすべて入力して、新しいプロジェクトを作成してください。

手順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>

上記のコードでは、ツールバーを格納するAppBarLayoutと、リストを表示するRecyclerViewを配置しています。

手順3：MainActivity.javaにコードを追加する

src/MainActivity.java に以下のコードを記述します。

import android.annotation.TargetApi;
import android.app.Activity;
import android.content.Intent;
import android.content.SharedPreferences;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
import android.support.v4.content.pm.ShortcutInfoCompat;
import android.support.v4.content.pm.ShortcutManagerCompat;
import android.support.v4.graphics.drawable.IconCompat;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.DefaultItemAnimator;
import android.support.v7.widget.DividerItemDecoration;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.widget.TextView;
import android.widget.Toast;
import android.support.v7.widget.Toolbar;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {
    private RecyclerView recyclerView;
    private customAdapter mAdapter;
    TextView text;
    ArrayList<String> list = new ArrayList<>();
    @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);
        recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
        RecyclerView.LayoutManager mLayoutManager = new LinearLayoutManager(getApplicationContext());
        recyclerView.setLayoutManager(mLayoutManager);
        recyclerView.setItemAnimator(new DefaultItemAnimator());
        mAdapter = new customAdapter(this,list);
        recyclerView.setAdapter(mAdapter);
        recyclerView.addItemDecoration(new DividerItemDecoration(recyclerView.getContext(), DividerItemDecoration.VERTICAL));
        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");
    }
}

このクラスでは、LinearLayoutManagerを使ってRecyclerViewを縦方向のリストとして初期化し、DividerItemDecorationで項目間に区切り線を追加しています。さらに、表示データとして文字列のArrayListを用意し、カスタムアダプター経由でRecyclerViewにセットしています。

手順4：Manifest.xmlにコードを追加する

Manifest.xml に以下のコードを記述します。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
    package = "com.example.myapplication">
    <uses-permission android:name = "android.permission.INTERNET" />
    <uses-permission android:name = "com.android.launcher.permission.INSTALL_SHORTCUT" />
    <application
        android:allowBackup = "true"
        android:theme = "@style/AppTheme.NoActionBar"
        android:icon = "@mipmap/ic_launcher"
        android:label = "@string/app_name"
        android:roundIcon = "@mipmap/ic_launcher_round"
        android:supportsRtl = "true">
        <activity
            android:name = ".MainActivity"
            android:configChanges = "keyboardHidden|orientation|screenSize">
            <intent-filter>
                <action android:name = "android.intent.action.MAIN" />
                <action android:name = "android.intent.action.CREATE_SHORTCUT" />
                <category android:name = "android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

手順5：customAdapter.javaにコードを追加する

customAdapter.java に以下のコードを記述します。

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;
    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) {
        this.context = context;
        this.list = list;
    }
    @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, int i) {
        myViewHolder.title.setText(list.get(i));
    }
    @Override
    public int getItemCount() {
        return list.size();
    }
}

このカスタムアダプターはRecyclerView.Adapterを継承しており、ViewHolderパターンを用いて各行のTextViewにデータをバインドします。onCreateViewHolderで行レイアウト（list_row.xml）を展開し、onBindViewHolderでリストの文字列を設定しています。

手順6：list_row.xmlにコードを追加する

リストの各行のレイアウトとなる list_row.xml に以下のコードを記述します。

<?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:cardBackgroundColor = "@color/colorAccent"
    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>

ここが本記事のポイントです。行レイアウトのルートにCardViewを配置することで、RecyclerViewの各項目がカードとして表示されます。app:cardCornerRadiusで角丸の大きさを、app:cardElevationで影の高さを、app:cardBackgroundColorで背景色をそれぞれ指定できます。

アプリを実行してみよう

それでは、アプリケーションを実行してみましょう。実際のAndroid端末をパソコンに接続していることを前提とします。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーのRunアイコンをクリックします。接続したモバイルデバイスを選択すると、端末に以下のような画面が表示されます。

補足：AndroidXへの移行について

本記事のサンプルコードは旧サポートライブラリ（android.support.*）を使用していますが、これらは現在非推奨となっています。新しいプロジェクトではAndroidX（androidx.*）の利用が推奨されるため、build.gradleに「androidx.recyclerview:recyclerview」と「androidx.cardview:cardview」の依存関係を追加し、インポート文を読み替えてください。基本的な実装の流れは同じです。