显示分页列表

创建分页列表,以便用户可以滚动查看超出单个屏幕的内容。水平分页列表有助于用户浏览图片、幻灯片或产品轮播等内容。垂直分页列表适用于内容丰富的应用,用户可能需要滚动浏览大量条目,例如文章。

版本兼容性

此实现要求您的项目 minSDK 设置为 API 级别 21 或更高版本。

依赖项

创建分页列表

您可以根据应用所需的方向配置水平或垂直分页列表。以下代码创建了一个显示 10 个项目的水平分页列表

代码要点

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

结果

图 1. HorizontalPager 的演示。

包含此指南的集合

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

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

有问题或反馈意见?

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