Listas: Especificações
Listas são índices verticais contínuos de texto e imagens
Variantes
Listas expressivas
Use a variante de lista expressiva para obter estilos mais flexíveis, estados de seleção destacados e slots personalizáveis.

Listas baseline
As listas baseline ainda estão disponíveis para uso, mas não têm o estilo visual, o tratamento de seleção nem a funcionalidade de slots mais recentes.
Na web, as listas expressivas são construídas com base nas listas baseline.
Ver especificações da lista baseline

| Variantes | M3 | M3 Expressive |
|---|---|---|
| Listas (expressivas) | -- | Disponível |
| Listas (baseline) | Disponível | Não recomendadas. Use listas expressivas em vez disso. |
Configurações
Estilos
Os estilos padrão e segmentado são escolhas visuais e não afetam o comportamento da lista.

- Padrão
- Segmentado
Seleção em listas
Uma lista pode ter apenas um modo de seleção ativo por vez. Por exemplo, uma lista de ação única pode ser alterada para uma lista de seleção múltipla, mas não pode operar nos dois modos ao mesmo tempo.




Interações de lista
As listas podem:
Mais sobre acessibilidade nas interações com listas

| Categoria | Configuração | M3 | M3 Expressive |
|---|---|---|---|
| Estilos | Padrão | Disponível | Disponível |
| Segmentado | -- | Disponível | |
| Modos de seleção | Ação única, múltiplas ações, seleção única, seleção múltipla | Disponível | Disponível |
| Interações | Expandir, deslizar\* | Disponível | Disponível |
* As interações de deslizar para revelar estão disponíveis apenas no Android Views
Tokens e especificações
Use o menu da tabela para selecionar um conjunto de tokens. O conjunto common combina tokens baseline com novas formas e tamanhos expressivos. O conjunto expand contém tokens para a interação de expansão. Saiba mais sobre tokens de design
Lista - Common
Lista - Expand
Anatomia

O contêiner e o texto do rótulo são obrigatórios. Todos os outros elementos são opcionais:
- Contêiner
- Overline
- Texto do rótulo
- Texto final
- Texto de apoio
- Ícone final
- Divisor
- Avatar inicial
- Ícone inicial
- Mídia inicial - imagem ou vídeo
Flexibilidade e slots
O M3 Design Kit inclui listas com slots personalizados para projetar layouts flexíveis de itens. Considere uma lista personalizada como um contêiner com três slots diferentes: inicial, de conteúdo e final. Cada slot pode conter um elemento diferente.
Acessibilidade dos slots
Os slots não são acessíveis por padrão. Observe as seguintes diretrizes:
- Os elementos devem seguir as regras, a estrutura e os padrões de interação das listas
- Use o espaçamento interno padrão do item de lista
- O tamanho da área de toque deve ser de pelo menos 48x48dp
- Não adicione elementos interativos que tornem o item de lista difícil de navegar, especialmente para pessoas que usam leitores de tela

- Slot inicial
- Slot de conteúdo
- Slot final
WARNING
Os slots exigem uma implementação de código personalizada, que deve ser criada e mantida por você
Os slots inicial e final devem ter largura menor que a seção de conteúdo.
1. Slots iniciais podem conter:
- Elementos visuais: Avatar, ícone, imagem ou miniatura de vídeo
- Controles de seleção: caixa de seleção, botão de opção ou interruptor
- Personalizações: Badge ou imagem maior
2. Os slots de conteúdo devem ter a maior largura e podem conter:
- Conteúdo padrão: Texto do rótulo, texto de apoio
- Complementos opcionais: Badge, ícone, rótulo inline ou outros elementos de texto
- Evite linhas longas de texto para preservar a legibilidade
3. Slots finais podem conter:
- Elementos de ação ou texto: Ícone, botão de ícone ou texto final
- Controles de seleção: Caixa de seleção, botão de opção ou interruptor

Listas de seleção
Para listas de seleção, use apenas uma interação de seleção por item de lista.


Cor
Os valores de cor são implementados por meio de tokens de design. Para designers, isso significa trabalhar com valores de cor correspondentes aos tokens. Na implementação, um valor de cor é um token que referencia um valor. Saiba mais sobre tokens de design

Funções de cor de lista usadas nos temas claro e escuro:
- Superfície
- Sobre a variante da superfície
- Sobre a superfície
- Sobre a variante da superfície
- Sobre a variante da superfície
- Sobre a variante da superfície
- Variante de contorno
- Contêiner primário
- Sobre o contêiner primário
- Sobre a variante da superfície
Estados
Os estados são representações visuais usadas para comunicar o estado de um componente ou de um elemento interativo. Saiba mais sobre estados de interação
Itens de lista padrão

- Habilitado
- Desabilitado
- Com o cursor sobre o item
- Em foco
- Pressionado
- Arrastado
Itens de lista selecionados

- Habilitado
- Desabilitado
- Com o cursor sobre o item
- Em foco
- Pressionado
- Arrastado
Medidas

Transformação de forma
Quando um item de lista é selecionado, a forma do canto muda para destacar o item ativo:
- Raio do canto de item não selecionado: 4dp interno, 16dp externo
- Raio do canto de item selecionado: 16dp


Lista (baseline)
A variante de lista baseline está disponível e continua funcionando em produtos existentes. No entanto, a variante de lista expressiva é recomendada para novos designs.
Tokens e especificações
Os tokens de lista baseline estão no conjunto de tokens common.
TIP
Este conjunto também inclui vários tokens expressivos.
Cor
Os valores de cor são implementados por meio de tokens de design. Para designers, isso significa trabalhar com valores de cor correspondentes aos tokens. Na implementação, um valor de cor é um token que referencia um valor. Saiba mais sobre tokens de design

Funções de cor de lista usadas nos temas claro e escuro:
- Superfície
- Sobre a superfície
- Sobre a variante da superfície
- Sobre a variante da superfície
- Sobre a variante da superfície
- Variante de contorno
- Contêiner primário
- Sobre o contêiner primário
- Sobre a variante da superfície
Estados
Os estados são representações visuais usadas para comunicar o estado de um componente ou de um elemento interativo.

- Habilitado
- Desabilitado
- Com o cursor sobre o item
- Em foco
- Pressionado
- Arrastado
Layout
Listas de uma linha


Listas de duas linhas


Listas de três linhas


| Atributo | Valor |
|---|---|
| Alinhamento do rótulo | Centralizado |
| Alinhamento do rótulo quando a altura é 88dp ou maior | No topo |
| Espaçamento interno à esquerda do rótulo | 16dp |
| Alinhamento vertical do elemento inicial | Centralizado |
| Alinhamento vertical do elemento inicial quando a altura é 88dp ou maior | No topo |
| Espaçamento interno à esquerda do elemento inicial | 16dp |
| Alinhamento vertical do ícone inicial | No topo |
| Espaçamento interno superior do ícone inicial | 8dp |
| Espaçamento interno superior do ícone inicial quando a altura é 88dp ou maior | 12dp |
| Alinhamento vertical do elemento final | Centralizado |
| Alinhamento vertical do elemento final quando a altura é 88dp ou maior | No topo |
| Espaçamento interno à esquerda do elemento final | 16dp |
| Espaçamento interno à direita do elemento final | 24dp |
| Espaçamento interno acima/abaixo do divisor | 0dp |
| Áreas de toque | 48dp |
| Divisor com largura total | 100% |
| Recuo à esquerda do divisor | 16dp |
| Recuo à direita do divisor | 24dp |
Configurações
Avatar inicial

- Com avatar inicial
- Com avatar inicial e caixa de seleção final
Imagem ou miniatura inicial

- Com imagem inicial
- Com imagem inicial e caixa de seleção final
Vídeo inicial

- Com vídeo inicial
- Com vídeo inicial e caixa de seleção final
Ícone inicial

- Com ícone inicial
- Com ícone inicial e caixa de seleção final
Somente texto

- Somente texto
- Com texto e caixa de seleção final
Caixa de seleção inicial

- Com caixa de seleção inicial
- Com caixa de seleção inicial e texto final
Botão de opção inicial

- Com botão de opção inicial
- Com botão de opção inicial e texto final
Interruptor final

- Com interruptor final
- Com ícone inicial e interruptor final