显示分页列表

创建分页列表,以便用户可以通过滚动来访问单屏无法容纳的内容。横向分页列表有助于用户浏览图片、幻灯片或产品轮播图等内容。垂直分页列表适用于需要用户滚动浏览大量条目(例如文章)的内容密集型应用。

版本兼容性

此实现要求您的项目最低 SDK (minSDK) 设置为 API 级别 21 或更高级别。

依赖项

创建分页列表

您可以配置横向或垂直分页列表,具体取决于您的应用所需的朝向。以下代码会创建一个显示 10 个条目的横向分页列表

代码要点

  • The HorizontalPager 可组合项提供了可横向滚动的条目列表。
    • 如需创建垂直分页列表,请改用 VerticalPager 可组合项。
  • 列表中的每个页面都包含一个 Text 对象,用于显示字符串“Page”和页索引号。
  • rememberPagerState() 实例会在用户离开时保留页面的状态,并在用户返回时显示同一页面。

结果

图 1. HorizontalPager 演示。

包含此指南的合集

此指南是以下精选快速指南合集的一部分,这些合集涵盖更广泛的 Android 开发目标

列表和网格可让您的应用以视觉上令人愉悦的形式显示集合,以便用户轻松使用。
了解可组合函数如何让您轻松创建基于 Material Design 设计系统的精美界面组件。
此系列视频介绍了各种 Compose API,快速展示了有哪些可用 API 以及如何使用它们。

有问题或反馈?

前往我们的常见问题页面,了解快速指南,或与我们联系并告诉我们您的想法。