可捲動的清單可協助管理資料集、建立回應式設計,並方便瀏覽。您可以使用有限的捲動清單,在應用程式中顯示較少的項目組合。如要避免大型資料集或長度不明的清單造成的效能問題,請參閱使用清單和 Paging 以 Lazy 方式載入資料。
版本相容性
這個實作方式需要將專案 minSDK 設為 API 級別 21 以上。
依附元件
建立垂直捲動清單
請使用下列程式碼建立垂直捲動清單:
@Composable private fun ScrollBoxes() { Column( modifier = Modifier .background(Color.LightGray) .size(100.dp) .verticalScroll(rememberScrollState()) ) { repeat(10) { Text("Item $it", modifier = Modifier.padding(2.dp)) } } }
程式碼的重點
- 使用
verticalScroll
修飾符和rememberScrollState
函式,設定Column
捲動行為。 - 如要建立水平捲動清單,請使用
horizontalScroll
修飾符建立Row
。
結果
![回應捲動手勢的垂直清單](https://developer.android.com/static/develop/ui/compose/images/gestures-simplescroll.gif?hl=zh-tw)
包含此指南的集合
本指南是精選的快速指南系列之一,涵蓋更廣泛的 Android 開發目標:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=zh-tw)
顯示清單或格狀
清單和格線可讓應用程式以視覺上賞心悅目且使用者易於取用的形式顯示集合。
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=zh-tw)
顯示互動式元件
瞭解可組合函式如何讓您輕鬆根據 Material Design 設計系統,建立美觀的 UI 元件。
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=zh-tw)
Compose 基本概念 (影片集合)
本系列影片將介紹各種 Compose API,快速向您展示可用的 API 和使用方式。
有問題或意見回饋嗎?
歡迎前往常見問題頁面,瞭解快速指南或與我們聯絡,分享您的想法。