As listas roláveis podem ajudar a gerenciar conjuntos de dados, criar designs responsivos e facilitar a navegação. É possível mostrar conjuntos menores de itens no app usando uma lista de rolagem finita. Para evitar problemas de desempenho com conjuntos de dados maiores ou uma lista de comprimento desconhecido, consulte Carregar dados de forma lenta com listas e paginação.
Compatibilidade de versões
Essa implementação exige que o minSDK do projeto seja definido como nível 21 da API ou mais recente.
Dependências
Criar uma lista de rolagem vertical
Use o código abaixo para criar uma lista de rolagem vertical:
@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)) } } }
Pontos principais sobre o código
- Define o comportamento de rolagem
Column
com o modificadorverticalScroll
e a funçãorememberScrollState
. - Para criar uma lista de rolagem horizontal, crie um
Row
com um modificadorhorizontalScroll
.
Resultados
![Uma lista vertical respondendo a gestos de
rolagem](https://developer.android.com/static/develop/ui/compose/images/gestures-simplescroll.gif?hl=pt-br)
Coleções que contêm este guia
Este guia faz parte destas coleções selecionadas de guias rápidos que abrangem metas mais amplas de desenvolvimento para Android:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=pt-br)
Mostrar uma lista ou grade
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=pt-br)
Mostrar componentes interativos
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=pt-br)