【Android】RecyclerViewでクリックされたアイテムとその位置（ポジション）を取得する方法

この記事では、AndroidのRecyclerViewにおいて、クリックされたアイテムとその位置（ポジション）を取得する方法を、実際のコード例とともに段階的に解説します。リストのアイテムがタップされたときに、そのアイテムのインデックス番号を受け取り、データの削除や画面遷移などの処理に活用できるようになります。

全体の流れ

今回作成するサンプルアプリでは、RecyclerViewに表示されたアイテムをタップすると、クリックされた位置をToastで表示し、該当するアイテムをリストから削除します。クリックイベントはカスタムインターフェース（onClickInterface）を通じてアダプターからアクティビティへ通知する構成です。

ステップ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>

このレイアウトでは、Toolbarを含むAppBarLayoutと、リスト表示用のRecyclerViewを配置しています。Toolbarはスクロールに連動して隠れる・表示される設定（scroll|snap|enterAlways）になっています。

ステップ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.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());
      recyclerView.setLayoutManager(mLayoutManager);
      recyclerView.setItemAnimator(new DefaultItemAnimator());
      mAdapter = new customAdapter(this, list, onclickInterface);
      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");
   }
}

ここでのポイントは、onClickInterfaceの実装部分です。setClick()メソッドには、アダプターから渡されたクリック位置（int型）が届きます。この例では、受け取った位置のアイテムをlist.remove()で削除し、Toastで位置を表示した後、notifyDataSetChanged()でRecyclerViewの表示を更新しています。

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

アダプター側では、onBindViewHolder()内で各アイテムのTextViewにOnClickListenerを設定し、クリック時にバインドされている位置（i）をonClickInterface.setClick()経由でアクティビティへ渡しています。これにより、どの行がタップされたかを正確に把握できます。

ステップ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"
   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で囲まれ、画像（ImageView）、タイトル用TextView、サブテキスト用TextViewが縦方向に並ぶ構成です。

ステップ6：onClickInterface.javaを作成する

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

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

このインターフェースは、アダプターとアクティビティ間でクリック情報を受け渡すための橋渡し役となります。引数にはクリックされたアイテムの位置が渡されます。

アプリを実行して動作を確認する

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

次に、リスト内のTextViewをタップしてみてください。クリックされたアイテムの位置がToastで表示され、該当アイテムがリストから削除されます。

まとめ

RecyclerViewでクリックされたアイテムの位置を取得するには、カスタムインターフェースを定義し、アダプターのonBindViewHolder()内でクリックリスナーを設定して位置を通知するのが定番の手法です。この仕組みを応用すれば、アイテムの削除だけでなく、詳細画面への遷移やチェック状態の管理など、さまざまなインタラクションを実装できます。