Listas: Especificaciones
Las listas son índices verticales continuos de texto e imágenes.
Variantes
Listas expresivas
Usa la variante de lista expresiva para obtener un estilo más flexible, estados de selección resaltados y slots personalizables.

Listas base
Las listas base siguen disponibles, pero no incluyen el estilo visual más reciente, el tratamiento de selección más actual ni la funcionalidad de slots.
En la web, las listas expresivas se basan en las listas base.
Ver las especificaciones de las listas base

| Variantes | M3 | M3 Expressive |
|---|---|---|
| Listas (expresivas) | -- | Disponible |
| Listas (base) | Disponible | No recomendado. Usa listas expresivas en su lugar. |
Configuraciones
Estilos
La elección entre el estilo estándar y el segmentado es puramente visual y no afecta el comportamiento de la lista.

- Estándar
- Segmentado
Selección de listas
Una lista solo puede usar un modo de selección a la vez. Por ejemplo, puede pasar de ser una lista de acción única a una lista de selección múltiple, pero no puede combinar ambos modos simultáneamente.




Interacciones de listas
Las listas pueden:
Más información sobre la accesibilidad de las interacciones de listas

| Categoría | Configuración | M3 | M3 Expressive |
|---|---|---|---|
| Estilos | Estándar | Disponible | Disponible |
| Segmentado | -- | Disponible | |
| Modos de selección | Acción única, acciones múltiples, selección única, selección múltiple | Disponible | Disponible |
| Interacciones | Expandir, deslizar\* | Disponible | Disponible |
* Las interacciones de deslizar para mostrar solo están disponibles en Android Views.
Tokens y especificaciones
Usa el menú de la tabla para seleccionar un conjunto de tokens. El conjunto common combina tokens base con nuevas formas y tamaños expresivos. El conjunto expand contiene los tokens para la interacción de expansión. Más información sobre los tokens de diseño
Lista - Common
Lista - Expand
Anatomía

Son obligatorios el contenedor y el texto de etiqueta. Todos los demás elementos son opcionales:
- Contenedor
- Sobrelínea
- Texto de etiqueta
- Texto final
- Texto de apoyo
- Icono final
- Divisor
- Avatar inicial
- Icono inicial
- Contenido multimedia inicial: imagen o video
Flexibilidad y slots
El M3 Design Kit incluye listas con slots personalizados para crear estructuras de elementos flexibles. Piensa en una lista personalizada como un contenedor con tres slots: inicial, de contenido y final. Cada slot puede contener un elemento distinto.
Accesibilidad de los slots
Los slots no son accesibles de forma predeterminada. Tenga en cuenta lo siguiente:
- Los elementos deben seguir las reglas, la estructura y los patrones de interacción de las listas
- Usa el relleno estándar de los elementos de lista
- El tamaño del área táctil debe ser de al menos 48x48dp
- No agregues elementos interactivos que dificulten la navegación dentro del elemento de lista, especialmente para las personas que usan lectores de pantalla
Más información sobre las pautas de accesibilidad requeridas

- Slot inicial
- Slot de contenido
- Slot final
WARNING
Los slots requieren una implementación de código personalizada que debes crear y mantener.
Las posiciones de los slots inicial y final deben tener un ancho menor que la sección de contenido.
1. Los slots iniciales pueden contener:
- Elementos visuales: avatar, icono, imagen o miniatura de video
- Controles de selección: casilla de verificación, botón de opción o interruptor
- Personalizaciones: insignia o imagen más grande
2. Los slots de contenido deben ser el slot de mayor ancho y pueden contener:
- Contenido predeterminado: texto de etiqueta, texto de apoyo
- Complementos opcionales: insignia, icono, etiqueta en línea o más elementos de texto
- Evita líneas de texto largas para preservar la legibilidad
3. Los slots finales pueden contener:
- Elementos de acción o texto: icono, botón de icono o texto final
- Controles de selección: casilla de verificación, botón de opción o interruptor

Listas de selección
Para las listas de selección, usa solo una interacción de selección por elemento de lista.


Color
Los valores de color se implementan mediante tokens de diseño. Para los diseñadores, esto implica trabajar con valores de color que se corresponden con los tokens. En la implementación, un valor de color será un token que hace referencia a un valor concreto. Más información sobre los tokens de diseño

Roles de color de las listas usados para temas claros y oscuros:
- Surface
- On surface variant
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- On surface variant
Estados
Los estados son representaciones visuales que se usan para comunicar el estado de un componente o de un elemento interactivo. Más información sobre los estados de interacción
Más información sobre el estado de foco de las listas
Elementos de lista predeterminados

- Habilitado
- Deshabilitado
- Con el cursor encima
- Enfocado
- Presionado
- Arrastrado
Elementos de lista seleccionados

- Habilitado
- Deshabilitado
- Con el cursor encima
- Enfocado
- Presionado
- Arrastrado
Medidas

Transformación de formas
Cuando se selecciona un elemento de lista, la forma de las esquinas cambia para resaltar el elemento activo:
- Radio de las esquinas sin seleccionar: 4dp interior, 16dp exterior
- Radio de las esquinas seleccionadas: 16dp


Lista (base)
La variante de lista base está disponible y sigue funcionando en los productos existentes. Sin embargo, se recomienda la variante de lista expresiva para los nuevos diseños.
Tokens y especificaciones
Los tokens de las listas base están en el conjunto de tokens common.
TIP
Este conjunto también incluye varios tokens expresivos.
Color
Los valores de color se implementan mediante tokens de diseño. Para los diseñadores, esto implica trabajar con valores de color que se corresponden con los tokens. En la implementación, un valor de color será un token que hace referencia a un valor concreto. Más información sobre los tokens de diseño

Roles de color de las listas usados para temas claros y oscuros:
- Surface
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- On surface variant
Estados
Los estados son representaciones visuales que se usan para comunicar el estado de un componente o de un elemento interactivo.

- Habilitado
- Deshabilitado
- Con el cursor encima
- Enfocado
- Presionado
- Arrastrado
Disposición
Listas de una línea


Listas de dos líneas


Listas de tres líneas


| Atributo | Valor |
|---|---|
| Alineación de la etiqueta | Centrada |
| Alineación de la etiqueta cuando la altura es de 88dp o superior | Superior |
| Relleno izquierdo de la etiqueta | 16dp |
| Alineación vertical del elemento inicial | Centrada |
| Alineación vertical del elemento inicial cuando la altura es de 88dp o superior | Superior |
| Relleno izquierdo del elemento inicial | 16dp |
| Alineación vertical del icono inicial | Superior |
| Relleno superior del icono inicial | 8dp |
| Relleno superior del icono inicial cuando la altura es de 88dp o superior | 12dp |
| Alineación vertical del elemento final | Centrada |
| Alineación vertical del elemento final cuando la altura es de 88dp o superior | Superior |
| Relleno izquierdo del elemento final | 16dp |
| Relleno derecho del elemento final | 24dp |
| Relleno por encima y por debajo del divisor | 0dp |
| Áreas táctiles | 48dp |
| Divisor de ancho completo | 100 % |
| Sangría izquierda del divisor | 16dp |
| Sangría derecha del divisor | 24dp |
Configuraciones
Avatar inicial

- Con avatar inicial
- Con avatar inicial y casilla de verificación final
Imagen o miniatura inicial

- Con imagen inicial
- Con imagen inicial y casilla de verificación final
Video inicial

- Con video inicial
- Con video inicial y casilla de verificación final
Icono inicial

- Con icono inicial
- Con icono inicial y casilla de verificación final
Solo texto

- Solo texto
- Con texto y casilla de verificación final
Casilla de verificación inicial

- Con casilla de verificación inicial
- Con casilla de verificación inicial y texto final
Botón de opción inicial

- Con botón de opción inicial
- Con botón de opción inicial y texto final
Interruptor final

- Con interruptor final
- Con icono inicial e interruptor final