【Android】RecyclerViewで水平方向のリストビュー（Horizontal ListView）を作成する方法

このチュートリアルでは、RecyclerViewを使用して水平方向にスクロールするリストビュー（Horizontal ListView）を構築する方法を、実際のサンプルコードとともにステップごとに解説します。

ステップ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 に以下のコードを追加します。

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.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);
        RecyclerView.LayoutManager mLayoutManager = new LinearLayoutManager(getApplicationContext(),LinearLayoutManager.HORIZONTAL, false);
        recyclerView.setLayoutManager(mLayoutManager);
        recyclerView.setItemAnimator(new DefaultItemAnimator());
        mAdapter = new customAdapter(this, list, onclickInterface);
        recyclerView.setAdapter(mAdapter);
        DividerItemDecoration dividerItemDecoration = new DividerItemDecoration(recyclerView.getContext(),
        DividerItemDecoration.HORIZONTAL);
        recyclerView.addItemDecoration(dividerItemDecoration);
        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");
    }
}

ここでのポイントは、LayoutManagerに LinearLayoutManager.HORIZONTAL を指定している箇所です。これにより、リストが垂直ではなく水平方向にスクロールするようになります。また、アイテムがクリックされると onClickInterface を通じて該当位置の要素がリストから削除され、Toastでその位置が表示された後にアダプターが更新されます。

ステップ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();
        }
}

RecyclerView.Adapter を継承したカスタムアダプターでは、各行の TextView にデータをバインドすると同時に、クリックリスナーを設定してタップイベントを Activity 側へ通知しています。

ステップ5：行レイアウト（list_row.xml）の作成

res/layout/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"
    android:padding = "10dp"
    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で構成されており、ImageViewと2つのTextViewが縦方向に並ぶシンプルなカード型レイアウトになっています。

ステップ6：クリックインターフェース（onClickInterface）の定義

src/onClickInterface.java に以下のコードを追加します。

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

このインターフェースを介して、アダプター側で検知したクリック位置（インデックス）をActivityに渡すことができます。

ステップ7：区切り線用のDrawable（divider.xml）の作成

res/drawable/divider.xml に以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<shape xmlns:android = "https://schemas.android.com/apk/res/android" android:shape = "rectangle">
    <solid android:color = "@color/colorPrimary"/>
    <size android:height = "2dp"/>
</shape>

このshapeリソースにより、リストアイテム間に高さ2dpの区切り線が描画されます。

アプリの実行

それでは、アプリを実行してみましょう。実機のAndroidスマートフォンをパソコンに接続しているものとします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。実行デバイスとして自分のモバイル端末を選択すると、端末に以下のような初期画面が表示されます。

※本記事のコードは旧サポートライブラリ（android.support.*）を使用しています。AndroidXを採用した新しいプロジェクトの場合は、import文やクラス名をAndroidX対応のもの（androidx.appcompat.widget.RecyclerView など）に適宜置き換えてください。