ページング リストを表示する

ページング リストを作成して、1 つの画面に収まらない大きすぎるコンテンツにユーザーがスクロールしてアクセスできるようにします。水平方向のページング リストは、画像、スライドショー、商品カルーセルなどのコンテンツをユーザーが移動する際に役立ちます。縦方向のページング リストは、記事など、ユーザーが多数のアイテムをスクロールする必要があるコンテンツが多いアプリに適しています。

バージョンの互換性

この実装では、プロジェクトの minSDK を API レベル 21 以上に設定する必要があります。

依存関係

ページング リストを作成する

アプリに必要な画面の向きに応じて、水平方向または垂直方向のページング リストを設定できます。次のコードは、10 個のアイテムを表示する水平方向のページング リストを作成します。

コードに関する主なポイント

  • HorizontalPager コンポーザブルは、横方向にスクロール可能なアイテムのリストを表示します。
    • 縦方向のページング リストを作成するには、代わりに VerticalPager コンポーザブルを使用します。
  • リスト内の各ページには、文字列「Page」とページ番号を表示する Text オブジェクトが含まれています。
  • rememberPagerState() のインスタンスは、ユーザーが別のページに移動したときにページの状態を保持し、ユーザーがそのページに戻ったときに同じページを表示します。

結果

図 1. HorizontalPager のデモ。

このガイドを含むコレクション

このガイドは、Android 開発の幅広い目標を網羅する、厳選されたクイックガイド コレクションの一部です。

リストとグリッドを使用すると、アプリでコレクションを視覚的に魅力的でユーザーが使いやすい形式で表示できます。
コンポーズ可能な関数を使用して、マテリアル デザインのデザイン システムに基づいて美しい UI コンポーネントを簡単に作成する方法を学びます。
この動画シリーズでは、さまざまな Compose API を紹介し、利用可能な API とその使用方法を簡単に説明します。

ご質問やフィードバックがある場合

よくある質問のページでクイックガイドをご覧になるか、お問い合わせフォームからご意見をお寄せください。