Partilhar via


RecyclerView

RecyclerView é um grupo de exibição para exibir coleções; ele foi projetado para ser um substituto mais flexível para grupos de exibição mais antigos, como ListView e GridView. Este guia explica como usar e personalizar o RecyclerView em aplicativos Xamarin.Android.

RecyclerView

Muitos aplicativos precisam exibir coleções do mesmo tipo (como mensagens, contatos, imagens ou músicas); Muitas vezes, essa coleção é muito grande para caber na tela, então a coleção é apresentada em uma pequena janela que pode rolar suavemente por todos os itens da coleção. RecyclerView é um widget Android que exibe uma coleção de itens em uma lista ou uma grade, permitindo que o usuário role pela coleção. Veja a seguir uma captura de tela de um aplicativo de exemplo que usa RecyclerView para exibir o conteúdo da caixa de entrada de email em uma lista de rolagem vertical:

Aplicativo de exemplo usando RecyclerView para listar mensagens da caixa de entrada

RecyclerView oferece dois recursos atraentes:

  • Ele tem uma arquitetura flexível que permite modificar seu comportamento conectando seus componentes preferidos.

  • Ele é eficiente com coleções grandes porque reutiliza exibições de item e requer o uso de suportes de exibição para armazenar em cache as referências de exibição.

Este guia explica como usar RecyclerView em aplicativos Xamarin.Android, explica como adicionar o RecyclerView pacote ao seu projeto Xamarin.Android e descreve como RecyclerView funciona em um aplicativo típico. Exemplos de código reais são fornecidos para mostrar como integrar RecyclerView ao seu aplicativo, como implementar o clique de exibição de item e como atualizar RecyclerView quando seus dados subjacentes são alterados. Este guia pressupõe que você esteja familiarizado com o desenvolvimento do Xamarin.Android.

Requisitos

Embora RecyclerView seja frequentemente associado ao Android 5.0 Lollipop, ele é oferecido como uma biblioteca de suporte – RecyclerView funciona com aplicativos que visam o nível de API 7 (Android 2.1) e posterior. O seguinte é necessário para usar RecyclerView em aplicativos baseados em Xamarin:

  • Xamarin.Android – Xamarin.Android 4.20 ou posterior deve ser instalado e configurado com o Visual Studio ou Visual Studio para Mac.

  • Seu projeto de aplicativo deve incluir o pacote Xamarin.Android.Support.v7.RecyclerView . Para obter mais informações sobre como instalar pacotes NuGet, consulte Demonstra Passo a passo: incluindo um NuGet em seu projeto.

Visão geral

RecyclerView pode ser pensado como um substituto para o ListView e GridView widgets no Android. Como seus antecessores, RecyclerView é projetado para exibir um grande conjunto de dados em uma pequena janela, mas RecyclerView oferece mais opções de layout e é melhor otimizado para exibir grandes coleções. Se você está familiarizado com ListViewo , existem várias diferenças importantes entre ListView e RecyclerView:

  • RecyclerView é um pouco mais complexo de usar: você tem que escrever mais código para usar RecyclerView em comparação com o ListView.

  • RecyclerView não fornece um adaptador predefinido; Você deve implementar o código do adaptador que acessa sua fonte de dados. No entanto, o Android inclui vários adaptadores predefinidos que funcionam com ListView e GridView.

  • RecyclerView não oferece um evento de clique no item quando um usuário toca em um item; Em vez disso, os eventos de clique no item são manipulados por classes auxiliares. Por outro lado, ListView oferece um evento de clique no item.

  • RecyclerView Melhora o desempenho reciclando modos de exibição e impondo o padrão de suporte de exibição, o que elimina pesquisas desnecessárias de recursos de layout. O uso do padrão de suporte de exibição é opcional no ListView.

  • RecyclerView é baseado em um design modular que facilita a personalização. Por exemplo, você pode conectar uma política de layout diferente sem alterações significativas de código em seu aplicativo. Em contraste, ListView é relativamente monolítico na estrutura.

  • RecyclerView Inclui animações internas para Adicionar e Remover Item. ListView As animações exigem algum esforço adicional por parte do desenvolvedor do aplicativo.

Seções

RecyclerView Peças e Funcionalidades

Este tópico explica como o Adapter, LayoutManagere ViewHolder funcionam juntos como classes auxiliares para dar suporte RecyclerViewao . Ele fornece uma visão geral de alto nível de cada uma dessas classes auxiliares e explica como você as usa em seu aplicativo.

Um exemplo básico de RecyclerView

Este tópico baseia-se nas informações fornecidas em RecyclerView Parts and Functionality fornecendo exemplos de código reais de como os vários RecyclerView elementos são implementados para criar um aplicativo de navegação de fotos do mundo real.

Estendendo o exemplo RecyclerView

Este tópico adiciona código adicional ao aplicativo de exemplo apresentado em A Basic RecyclerView Example para demonstrar como manipular eventos de clique em item e atualizar RecyclerView quando a fonte de dados subjacente é alterada.

Resumo

Este guia apresentou o widget Android RecyclerView , explicou como adicionar a RecyclerView biblioteca de suporte a projetos Xamarin.Android, como RecyclerView recicla visualizações, como impõe o padrão de suporte de visualização para eficiência e como as várias classes auxiliares que compõem RecyclerView colaboram para exibir coleções. Ele forneceu código de exemplo para demonstrar como RecyclerView é integrado a um aplicativo, explicou como personalizar RecyclerViewa política de layout do conectando diferentes gerenciadores de layout e descreveu como manipular eventos de clique no item e notificar RecyclerView alterações na fonte de dados.

Para obter mais informações sobre RecyclerViewo , consulte a referência da classe RecyclerView.