Mostrar uma lista de paginação

Crie uma lista de paginação para que os usuários possam rolar para acessar conteúdo muito grande para caber em uma única tela. As listas de paginação horizontal podem ajudar os usuários a navegar por conteúdos como imagens, apresentações de slides ou carrosséis de produtos. As listas de paginação vertical são úteis para apps com muito conteúdo, em que os usuários precisam rolar um grande número de itens, como artigos.

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 paginação

É possível configurar uma lista de paginação horizontal ou vertical, dependendo da orientação necessária para o app. O código a seguir cria uma lista de paginação horizontal que mostra 10 itens:

Pontos principais sobre o código

  • O elemento combinável HorizontalPager fornece uma lista de itens rolável na horizontal.
    • Para criar uma lista de paginação vertical, use o elemento combinável VerticalPager.
  • Cada página na lista contém um objeto Text que mostra a string "Page" e o número de índice da página.
  • Uma instância de rememberPagerState() persiste o estado de uma página quando o usuário sai dela e mostra a mesma página quando o usuário volta para ela.

Resultados

Figura 1. Demonstração de HorizontalPager.

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:

As listas e as grades permitem que o app exiba coleções de uma forma agradável e fácil de consumir.
Aprenda como as funções combináveis podem permitir que você crie componentes de interface bonitos com base no sistema de design do Material Design.
Esta série de vídeos apresenta várias APIs do Compose, mostrando rapidamente o que está disponível e como usá-las.

Tem dúvidas ou feedback?

Acesse a página de perguntas frequentes e saiba mais sobre os guias rápidos ou entre em contato e conte o que você pensa.