Listas: Diretrizes
Listas são índices verticais contínuos de texto e imagens

- Imagens, vídeos, ícones ou avatares na posição inicial
- Texto, ícones ou botões de ícone na posição final
Uso
Listas são grupos verticais de texto, ícones, imagens e outros elementos, projetados para facilitar a leitura e a compreensão.
Itens de lista podem conter várias ações ao mesmo tempo, como seleção, botões de ícone, menus de overflow e outros.

Use listas para comunicar ou selecionar itens distintos, como escolher entre um conjunto de cores.

Uma lista deve permitir uma leitura rápida. Qualquer elemento pode servir como ponto de referência para alinhar o conteúdo do item de lista.
Coloque elementos visuais de suporte e texto principal na mesma posição em cada item de lista.
Não varie a posição dos elementos entre os itens de uma lista.

- Lista de exemplo
- Posicionamento do conteúdo em uma fileira
- Os elementos visuais de suporte estão alinhados para facilitar a leitura rápida
- O texto principal está alinhado para facilitar a leitura rápida
Itens de lista podem se adaptar a diferentes comprimentos de texto:
Somente texto do rótulo
Um item de lista pode conter uma única linha de texto do rótulo. Se o texto não couber em uma linha, ele pode continuar na linha seguinte ou ser truncado.
Texto do rótulo com texto de apoio
Um item de lista pode incluir texto de apoio abaixo do texto do rótulo. Tanto o texto do rótulo quanto o texto de apoio podem continuar na linha seguinte ou ser truncados.

- Somente texto do rótulo
- Texto do rótulo com texto de apoio em uma linha
- Texto do rótulo com texto de apoio que ocupa duas linhas
Anatomia

- Contêiner
- Texto do rótulo
- Texto de apoio
- Texto na posição final
- Ícone na posição final
- Controle de seleção na posição final - caixa de seleção, botão de rádio, interruptor
- Contêiner de avatar na posição inicial
- Texto do avatar na posição inicial
- Ícone na posição inicial
- Mídia na posição inicial - imagem ou vídeo
Contêiner
Contêineres de lista abrangem todos os itens de lista e seus elementos. O tamanho do item de lista é determinado pelo elemento mais alto em seu interior. Consulte as medidas de layout
Quando um item de lista exibe uma imagem, considere personalizar a cor do contêiner para usar um esquema de cores baseado em conteúdo. Isso deve ser aplicado ao estado habilitado ou durante uma interação.
Rótulo e texto de apoio
Mantenha o texto do rótulo conciso.
Para garantir que os itens de lista sejam fáceis de ler rapidamente:
- Limite o texto de apoio a uma a três linhas
- Trunque o texto de apoio, dependendo do tamanho da tela

Ícones
Ícone na posição inicial
Um ícone na posição inicial deve fornecer uma referência visual rápida relacionada ao texto do rótulo do item, ajudando a facilitar a leitura rápida da lista.
Ícone na posição final
Um ícone na posição final costuma ser usado para comunicar status ou indicar uma ação, como Mostrar mais.

- Os ícones na posição inicial devem estar relacionados ao texto do rótulo
- Os ícones na posição final podem comunicar uma ação
Mídia na posição inicial
Itens de lista podem conter um avatar, uma imagem ou um vídeo na posição inicial. Ancore os elementos visuais à borda inicial da lista para permitir uma leitura rápida.
Miniaturas de vídeo na posição inicial podem abrir um reprodutor de vídeo ou até mesmo reproduzir o vídeo dentro da lista.


Avatares
Itens de lista podem incluir imagens em formas circulares ou expressivas para representar uma pessoa ou entidade.
Use imagens quadradas ou retangulares para outros conteúdos, como produtos ou vídeos.

Ações primárias e secundárias
Use espaçamento para chamar a atenção para o aspecto mais importante do item de lista, geralmente a área de ação primária ou o conteúdo principal.

A ação primária ocupa mais espaço:
- Área de ação primária
- Área de ação secundária

Alinhe o conteúdo por importância:
- Conteúdo mais relevante
- Conteúdo menos relevante
Texto na posição final
O texto na posição final pode fornecer informações adicionais sobre um item de lista, como preço, quantidade ou outros detalhes.

Controles de seleção
Controles de seleção exibem as ações do item de lista. Posicione os controles na extremidade inicial ou final de um item de lista:
- Use caixas de seleção para selecionar vários itens
- Use interruptores para ativar ou desativar configurações
- Use botões de rádio para selecionar um único item

- Caixas de seleção
- Interruptores
- Botões de rádio
Intervalos e divisores
Intervalos ou divisores podem separar uma lista em itens e grupos:
- Use intervalos para listas com contêiner. Os intervalos aproveitam formas expressivas e estratégias de contenção.
- Limite os divisores a listas sem contêiner ou complexas, somente quando uma separação visual mais forte for necessária.


Design adaptativo
Comprimento da linha
Em layouts fluidos, evite linhas de texto excessivamente longas ao expandir contêineres e componentes que contenham muito texto. Isso geralmente significa alterar margens e propriedades tipográficas conforme o contêiner é dimensionado.

Adapte a largura do contêiner da lista com base no comprimento de uma linha ou troque para um layout de várias colunas.

O comprimento ideal de uma linha de texto fica entre 40 e 60 caracteres, mas dispositivos com telas grandes podem acomodar até 120 caracteres por linha. Se uma linha de texto estiver próxima de 120 caracteres, considere aumentar a altura da linha para melhorar a legibilidade.

Uma lista exibida em um breakpoint compacto pode se tornar parte de um layout de duas colunas em um breakpoint expandido, ajustando a quantidade de informações exibidas em cada item de lista.
Adaptar elementos e layout da lista
As listas podem alterar o layout para se adaptar a diferentes breakpoints. Isso afeta o tamanho e o posicionamento do conteúdo.
Por exemplo, uma lista em um breakpoint compacto pode ajustar margens, espaçamento ou densidade para se adequar melhor a uma janela expandida.
Trocar componentes
Listas são, em essência, uma composição compacta de imagens, texto e ações. Outros componentes, como cartões e carrosséis, usam os mesmos elementos, mas ocupam mais espaço.
Em breakpoints maiores, considere trocar uma lista por um componente com propósito semelhante para aproveitar o espaço disponível.
Breakpoints compactos
As listas devem se estender de ponta a ponta em janelas compactas. Selecionar um item de lista deve abrir uma página com os detalhes.
Breakpoints médios e expandidos
Breakpoints médios e breakpoints expandidos, como telas de tablet e desktop, podem exibir conteúdo primário e secundário na mesma visualização.
Por exemplo, uma lista e as informações detalhadas podem aparecer lado a lado.

Em um breakpoint maior, uma lista pode se transformar em um carrossel.
As listas também podem mostrar mais ou menos conteúdo à medida que aumentam e diminuem de tamanho.
Por exemplo, um item de lista pode revelar mais conteúdo quando o componente é expandido.
Comportamento
Modos de seleção de lista
O estado selecionado se aplica ao item de lista como um todo. Por exemplo, quando um item com uma caixa de seleção é selecionado, tanto o item de lista quanto a caixa de seleção mostram um estado selecionado.
Seleção única
As listas podem apresentar um componente de seleção única, como um botão de rádio.
Itens de lista de seleção única:
- Não suportam múltiplas ações
- Não podem ter ações secundárias aninhadas
- Não devem usar caixas de seleção

Seleção múltipla
Listas de seleção múltipla permitem que vários itens de lista sejam selecionados.
Itens de lista de seleção múltipla:
- São compatíveis com caixas de seleção e interruptores
- Não podem ter ações secundárias aninhadas
- Não devem usar botões de rádio

Ação única
Em uma lista de ação única, o item de lista inteiro executa uma ação, como navegar para uma nova página.
Itens de lista de ação única:
- Não podem ter ações secundárias aninhadas
- Não podem ser alternados para um estado selecionado persistente

Ação múltipla
Listas de ação múltipla podem oferecer suporte a múltiplas ações aninhadas dentro de um item de lista.
A ação primária deve ocupar a maior parte do espaço nas posições inicial e de conteúdo.
Coloque ações complementares, como um marcador ou um menu, na posição final.

Não interativo
Listas não interativas podem organizar informações de forma fácil de ler rapidamente. Elas não executam nenhuma ação e não podem ser selecionadas.

Interações de lista
Expandir e recolher
Itens de lista que contêm outros itens de lista podem ser expandidos e recolhidos de forma semelhante a pastas, para revelar ou ocultar conteúdo.
Tocar em um item de lista o expande verticalmente por toda a tela usando o padrão de transição Container Transform.
Gesto de deslizar
No Android, os itens de lista podem revelar botões quando o usuário desliza o dedo na horizontal sobre eles. Use uma combinação de estilos de botão para criar interesse visual e hierarquia.
A ação primária deve ser a última opção, alinhada à extremidade final. Um deslize completo aciona essa ação, movendo o item de lista e as demais ações para fora da tela.
Itens de lista que aceitam deslizar devem incluir maneiras alternativas de acessar ações ocultas, como um ícone de mais opções.
