顯示分頁清單

建立分頁清單,讓使用者可以捲動畫面,存取無法在單一畫面上顯示的大型內容。水平分頁清單可協助使用者瀏覽圖片、幻燈片或產品輪播圖片等內容。垂直分頁清單適用於內容量龐大的應用程式,因為使用者可能需要捲動大量項目 (例如文章)。

版本相容性

這個實作方式需要將專案 minSDK 設為 API 級別 21 以上。

依附元件

建立分頁清單

您可以根據應用程式所需的方向,設定水平或垂直分頁清單。以下程式碼會建立水平分頁清單,顯示 10 個項目:

程式碼的重點

  • HorizontalPager 可組合函式提供可水平捲動的項目清單。
    • 如要建立垂直分頁清單,請改用 VerticalPager 可組合函式。
  • 清單中的每個頁面都包含 Text 物件,用於顯示字串「Page」和頁面索引編號。
  • 當使用者離開網頁時,rememberPagerState() 的例項會保留網頁狀態,並在使用者返回時顯示相同的網頁。

結果

圖 1. HorizontalPager 的示範。

包含此指南的集合

本指南是精選的快速指南系列之一,涵蓋更廣泛的 Android 開發目標:

清單和格線可讓應用程式以視覺上賞心悅目且使用者易於取用的形式顯示集合。
瞭解可組合函式如何讓您輕鬆根據 Material Design 設計系統,建立美觀的 UI 元件。
本系列影片將介紹各種 Compose API,快速向您展示可用的 API 和使用方式。

有問題或意見回饋嗎?

請前往常見問題頁面,瞭解快速指南或與我們聯絡,分享您的想法。