このページは Cloud Translation API によって翻訳されました。

RecyclerView を Lazy リストに移行する

RecyclerView は、大規模なデータセットを簡単に効率的に表示できるビューコンポーネントです。データセット内の各アイテムにビューを作成する代わりに、RecyclerView はビューの小さなプールを保持し、アイテムをスクロールするときにそれらを再利用することで、アプリのパフォーマンスを向上させます。

Compose では、遅延リストを使用して同じことを実現できます。このページでは、RecyclerView の実装を移行して Compose で遅延リストを使用する方法について説明します。

移行手順

RecyclerView の実装を Compose に移行する手順は次のとおりです。

UI 階層から RecyclerView をコメントアウトするか削除し、階層にまだ存在しない場合は ComposeView を追加して置き換えます。これは、追加する Lazy リストのコンテナです。

      <FrameLayout
          android:layout_width="match_parent"
          android:layout_height="match_parent">

  <!--    <androidx.recyclerview.widget.RecyclerView-->
  <!--            android:id="@+id/recycler_view"-->
  <!--            android:layout_width="match_parent"-->
  <!--            android:layout_height="match_parent />"-->

          <androidx.compose.ui.platform.ComposeView
              android:id="@+id/compose_view"
              android:layout_width="match_parent"
              android:layout_height="match_parent" />

      </FrameLayout>

RecyclerView のレイアウトマネージャーに基づいて、必要な Lazy list コンポーザブルのタイプを決定します（下の表を参照）。選択したコンポーザブルは、前の手順で追加した ComposeView の最上位コンポーザブルになります。

`LayoutManager`	コンポーザブル
`LinearLayoutManager`	`LazyColumn` または `LazyRow`
`GridLayoutManager`	`LazyVerticalGrid` または `LazyHorizontalGrid`
`StaggeredGridLayoutManager`	`LazyVerticalStaggeredGrid` または `LazyHorizontalStaggeredGrid`

// recyclerView.layoutManager = LinearLayoutManager(context)
composeView.setContent {
    LazyColumn(Modifier.fillMaxSize()) {
        // We use a LazyColumn since the layout manager of the RecyclerView is a vertical LinearLayoutManager
    }
}MigrationCommonScenariosSnippets.kt

RecyclerView.Adapter の実装で、ビュータイプごとに対応するコンポーザブルを作成します。通常、各ビュータイプは ViewHolder サブクラスにマッピングされますが、必ずしもそうとは限りません。これらのコンポーザブルは、リスト内のさまざまなタイプの要素の UI 表現として使用されます。
```
@Composable
fun ListItem(data: MyData, modifier: Modifier = Modifier) {
    Row(modifier.fillMaxWidth()) {
        Text(text = data.name)
        // … other composables required for displaying `data`
    }
}MigrationCommonScenariosSnippets.kt
```
RecyclerView.Adapter の onCreateViewHolder() メソッドと onBindViewHolder() メソッドのロジックは、これらのコンポーザブルと、コンポーザブルに指定する状態に置き換えられます。Compose では、アイテムのコンポーザブルの作成とデータのバインディングは分離されていません。これらのコンセプトは統合されています。
遅延リストの content スロット（末尾のラムダパラメータ）内で、items() 関数（または同等のオーバーロード）を使用して、リストのデータを反復処理します。itemContent ラムダで、データに適したコンポーザブルアイテムを呼び出します。
```
val data = listOf<MyData>(/* ... */)
composeView.setContent {
    LazyColumn(Modifier.fillMaxSize()) {
        items(data) {
            ListItem(it)
        }
    }
}MigrationCommonScenariosSnippets.kt
```

一般的なユースケース

アイテムのデコレーション

RecyclerView には ItemDecoration というコンセプトがあり、リスト内のアイテムに特別な描画を追加できます。たとえば、ItemDecoration を追加してアイテムの間に区切り線を追加できます。

val itemDecoration = DividerItemDecoration(recyclerView.context, LinearLayoutManager.VERTICAL)
recyclerView.addItemDecoration(itemDecoration)MigrationCommonScenariosSnippets.kt

Compose には、アイテムの装飾に相当するコンセプトがありません。代わりに、リスト内の UI 装飾をコンポジションに直接追加できます。たとえば、リストに区切り線を追加するには、各アイテムの後に Divider コンポーザブルを使用します。

LazyColumn(Modifier.fillMaxSize()) {
    itemsIndexed(data) { index, d ->
        ListItem(d)
        if (index != data.size - 1) {
            HorizontalDivider()
        }
    }
}MigrationCommonScenariosSnippets.kt

アイテムアニメーション

ItemAnimator を RecyclerView に設定すると、アダプターに変更が加えられたときにアイテムの外観をアニメーション化できます。デフォルトでは、RecyclerView は削除、追加、移動イベントの基本的なアニメーションを提供する DefaultItemAnimator を使用します。

遅延リストには、animateItemPlacement 修飾子による同様のコンセプトがあります。詳しくは、アイテムのアニメーションをご覧ください。

参考情報

RecyclerView を Compose に移行する方法について詳しくは、次のリソースをご覧ください。

リストとグリッド: Compose でリストとグリッドを実装する方法に関するドキュメント。
Jetpack Compose の相互運用: RecyclerView で Compose を使用する: RecyclerView 内で Compose を効率的に使用する方法に関するブログ投稿。

あなたへのおすすめ

注: JavaScript がオフになっている場合はリンクテキストが表示されます
リストとグリッド
CoordinatorLayout を Compose に移行する
その他の考慮事項