[Android/XML] RecyclerViewでリスト表示をする

Contents 非表示

実装

dependencies

tomlに以下を追加

[versions]
recyclerview = "1.3.2" // 適したVersionを入れる

[libraries]
androidx-recyclerview = { group = "androidx.recyclerview", name = "recyclerview", version.ref = "recyclerview" }

build.gradle (モジュール)に追加

dependencies {
	implementation(libs.androidx.recyclerview)
}

Syncする。

Layout

activity_main.xmlにRecyclerViewを配置

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        tools:listitem="@layout/list_item" /> </androidx.constraintlayout.widget.ConstraintLayout>

list_item.xmlというレイアウトファイルを作成、これが各Cellのアイテム構成になる。

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_margin="8dp"
    app:cardCornerRadius="8dp"
    app:cardElevation="4dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        android:padding="16dp">

        <TextView
            android:id="@+id/titleTextView"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textStyle="bold"
            android:textSize="18sp"
            android:text="Item Title" />

        <TextView
            android:id="@+id/subtitleTextView"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="14sp"
            android:text="This is a subtitle for the item."
            android:layout_marginTop="4dp" />

    </LinearLayout>

</androidx.cardview.widget.CardView>

Data

MyItemというファイルを作成

data class MyItem(
	val title: String,
	val subtitle: String
)

MyAdapterというファイルを作成、Listの構成を決めるファイル

class MyAdapter(private val itemList: List<MyItem>) :
	RecyclerView.Adapter<MyAdapter.MyViewHolder>() {

	// (1) ViewHolderクラスの定義
	// 各リストアイテムのView要素を保持する。
	class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
		val titleTextView: TextView = itemView.findViewById(R.id.titleTextView)
		val subtitleTextView: TextView = itemView.findViewById(R.id.subtitleTextView)
	}

	// (2) ViewHolderの作成
	// 新しいViewHolderが必要になったときに呼び出される。
	// ここでリストアイテムのレイアウトをViewオブジェクトに変換(inflate)する。
	override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
		val view = LayoutInflater.from(parent.context)
			.inflate(R.layout.list_item, parent, false)
		return MyViewHolder(view)
	}

	// (3) データのバインド
	// 指定された位置(position)のデータをViewHolderにバインド(表示)する。
	override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
		val currentItem = itemList[position]
		holder.titleTextView.text = currentItem.title
		holder.subtitleTextView.text = currentItem.subtitle

		// (オプション) アイテムクリックリスナー
		holder.itemView.setOnClickListener {
			Toast.makeText(holder.itemView.context, "Clicked: ${currentItem.title}", Toast.LENGTH_SHORT).show()
		}
	}

	// (4) アイテム数の取得
	override fun getItemCount(): Int {
		return itemList.size
	}
}

View

MainActivityは以下のように

class MainActivity : AppCompatActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContentView(R.layout.activity_main)
		val recyclerView: RecyclerView = findViewById(R.id.recyclerView)

		val data = mutableListOf<MyItem>()
		for (i in 1..20) {
			data.add(MyItem("タイトル $i", "サブタイトル $i."))
		}

		recyclerView.layoutManager = LinearLayoutManager(this)
		recyclerView.adapter = MyAdapter(data)
	}
}