Material Design 3
Este skill guía la implementación de Material Design 3 (MD3) de Google, un sistema de diseño personal, adaptativo y expresivo. MD3 utiliza color dinámico, superficies tonales, formas redondeadas y movimiento basado en resortes para crear interfaces que se sienten vivas y personales.
Filosofía
MD3 se basa en tres principios:
- Personal: El color dinámico adapta la UI al fondo de pantalla o contenido del usuario. La tematización es individual, no universal.
- Adaptativo: Los diseños se transforman en 5 clases de tamaño de ventana. Los componentes se redimensionan, reposicionan y cambian de factor de forma de manera responsiva.
- Expresivo: La morfología de formas, la física de resortes y la tipografía enfatizada crean momentos de deleite sin sacrificar la usabilidad.
Actualizaciones recientes: Google I/O 2026
La actualización de Google I/O 2026 de Material refuerza una ruta Compose-first para Android y expande la guía expresiva/adaptativa:
- Material Android es Compose-first: Para trabajos nuevos en Android, prefiere Jetpack Compose Material3 para obtener los últimos componentes, APIs expresivas, scaffolds adaptativos e integración con la API de Styles. Las Android Views pueden ser necesarias en aplicaciones existentes, pero no deben tratarse como la ruta predeterminada para nuevas implementaciones de Material 3.
- Sistema de diseño expresivo: Utiliza un scaffold de diseño expresivo para adaptar pantallas a través de dispositivos móviles, escritorios, plegables, relojes, XR y otros factores de forma espaciales. Empieza desde scaffolds adaptativos/clases de tamaño de ventana en lugar de diseños fijos centrados en teléfonos.
- Sistema de espaciado de 8dp: Aplica tokens de espaciado para márgenes, rellenos y espacios, de modo que los diseños y componentes puedan adaptarse programáticamente al tipo de dispositivo y densidad.
- Componentes expresivos nuevos/actualizados: Las listas, menús, búsqueda y barras de aplicación de búsqueda tienen guías expresivas renovadas, con Jetpack Compose como objetivo de implementación principal.
- Relojes y XR: Los relojes enfatizan el movimiento basado en física, texto en arco y contenedores ajustados al borde. XR enfatiza paneles espaciales y elevación basada en profundidad.
Diferencias clave con MD2:
- Las superficies tonales reemplazan las sombras de elevación como la señal de profundidad principal
- El color dinámico genera esquemas completos a partir de un solo color semilla
- Esquinas completamente redondeadas por defecto (no ligeramente redondeadas)
- La física de movimiento basada en resortes reemplaza las curvas de easing fijas para componentes
- 3 niveles de contraste controlados por el usuario (estándar/medio/alto)
Relación con el skill de frontend-design: Cuando ambos skills están activos, MD3 proporciona el sistema de diseño (tokens, componentes, reglas de diseño) y frontend-design proporciona dirección creativa dentro de esas restricciones. Las reglas de MD3 tienen prioridad para la estructura de componentes y el uso de tokens. Nota: Roboto/Roboto Flex ES la tipografía predeterminada correcta en MD3; la guía de frontend-design para evitar Roboto no aplica al implementar MD3.
Árbol de decisión
¿Qué estás construyendo?
Scaffold completo de aplicación → Ver "Patrones comunes: App Shell" + referencias/layout-and-responsive.md
Componente único → Ver "Referencia rápida de componentes" → referencias/component-catalog.md
Tema personalizado → Ver referencias/theming-and-dynamic-color.md
Formulario / diseño de entrada → Ver referencias/component-catalog.md § Componentes de entrada
Estructura de navegación → Ver referencias/navigation-patterns.md
Visualización de datos → Ver referencias/component-catalog.md § Visualización de datos
¿Qué plataforma?
Jetpack Compose → Principal: androidx.compose.material3, MaterialTheme, referencias/*
Flutter → useMaterial3: true en ThemeData, ColorScheme.fromSeed()
Web (JavaScript vanilla) → @material/web (limitado; modo mantenimiento) + propiedades personalizadas CSS
Web (React/Vue/Svelte) → Propiedades personalizadas CSS + componentes envolventes (sin librería oficial de React)
Web (solo CSS) → Valores de tokens MD3 como propiedades personalizadas CSS (sin elementos <md-*>)
Sistema de tokens de diseño
Todos los tokens de MD3 usan el espacio de nombres md.sys. Jetpack Compose mapea roles a MaterialTheme.colorScheme, MaterialTheme.typography y MaterialTheme.shapes (mismos roles semánticos que la especificación). En la web, estos se mapean a propiedades personalizadas CSS (--md-sys-*):
Tokens de color (--md-sys-color-*)
| Token | Propósito |
|---|---|
primary | Rellenos de alta énfasis, texto, iconos sobre superficie |
on-primary | Texto/iconos sobre primary |
primary-container | Relleno destacado para componentes clave (FAB, etc.) |
on-primary-container | Texto/iconos sobre primary-container |
secondary / on-secondary | Acentos menos prominentes |
secondary-container / on-secondary-container | Componentes recesivos (botones tonales) |
tertiary / on-tertiary | Acentos contrastantes |
tertiary-container / on-tertiary-container | Contenedores complementarios |
error / on-error | Estados de error (estáticos — no cambian con color dinámico) |
error-container / on-error-container | Rellenos de contenedor de error |
surface | Fondo predeterminado |
on-surface | Texto/iconos sobre cualquier superficie |
on-surface-variant | Texto/iconos de menor énfasis sobre superficie |
surface-container-lowest | Contenedor de menor énfasis |
surface-container-low | Contenedor de énfasis bajo |
surface-container | Contenedor predeterminado (áreas de navegación) |
surface-container-high | Contenedor de énfasis alto |
surface-container-highest | Contenedor de énfasis más alto |
surface-dim / surface-bright | Mantienen brillo relativo entre claro/oscuro |
inverse-surface / inverse-on-surface / inverse-primary | Elementos contrastantes (snackbars) |
outline | Límites importantes (bordes de campos de texto) |
outline-variant | Elementos decorativos (divisores) |
Detalles completos: references/color-system.md
Tokens de tipografía (--md-sys-typescale-*)
| Escala | Tamaños | Uso |
|---|---|---|
| Display | L / M / S | Texto heroico, números grandes |
| Headline | L / M / S | Encabezados de sección |
| Title | L / M / S | Encabezados más pequeños, títulos de tarjetas |
| Body | L / M / S | Texto de párrafo, descripciones |
| Label | L / M / S | Botones, chips, subtítulos |
Cada estilo tiene tokens para: -font, -weight, -size, -line-height, -tracking
Además, 15 variantes enfatizadas (peso mayor) mediante --md-sys-typescale-emphasized-*
Detalles completos: references/typography-and-shape.md
Tokens de forma (--md-sys-shape-corner-*)
| Token | Valor | Componentes de ejemplo |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | Chips, snackbars |
small | 8dp | Campos de texto, menús |
medium | 12dp | Tarjetas |
large | 16dp | FABs, panel de navegación |
large-increased | 20dp | (Expresivo) |
extra-large | 28dp | Diálogos, hojas inferiores |
extra-large-increased | 32dp | (Expresivo) |
extra-extra-large | 48dp | (Expresivo) |
full | 9999px | Botones, chips, insignias |
Niveles de elevación
| Nivel | DP | Desplazamiento tonal | Uso |
|---|---|---|---|
| 0 | 0dp | Ninguno | Superficies planas, la mayoría de componentes en reposo |
| 1 | 1dp | +5% primary | Tarjetas elevadas, hojas modales |
| 2 | 3dp | +8% primary | Menús, barra de navegación, barra de aplicación desplazada |
| 3 | 6dp | +11% primary | FAB, diálogos, búsqueda, selectores de fecha/hora |
| 4 | 8dp | +12% primary | (solo aumento al pasar el ratón/enfocar) |
| 5 | 12dp | +14% primary | (solo aumento al pasar el ratón/enfocar) |
La elevación en MD3 se comunica a través del color de superficie tonal, no sombras. Las sombras solo se usan cuando se necesita protección adicional contra fondos recargados.
Movimiento
MD3 Expressive (mayo 2025) introdujo física de movimiento basada en resortes para componentes. El sistema heredado de easing/duración todavía se usa para transiciones (entrada/salida/eje compartido):
| Easing | Duración | Tipo de transición |
|---|---|---|
| Enfatizado | 500ms | Comienza y termina en pantalla |
| Enfatizado desacelerado | 400ms | Entrada a la pantalla |
| Enfatizado acelerado | 200ms | Salida de la pantalla |
| Estándar | 300ms | Comienza y termina en pantalla (utilidad) |
| Estándar desacelerado | 250ms | Entrada a pantalla (utilidad) |
| Estándar acelerado | 200ms | Salida de pantalla (utilidad) |
Valores CSS de easing:
- Enfatizado:
cubic-bezier(0.2, 0, 0, 1) - Enfatizado desacelerado:
cubic-bezier(0.05, 0.7, 0.1, 1) - Enfatizado acelerado:
cubic-bezier(0.3, 0, 0.8, 0.15) - Estándar:
cubic-bezier(0.2, 0, 0, 1) - Estándar desacelerado:
cubic-bezier(0, 0, 0, 1) - Estándar acelerado:
cubic-bezier(0.3, 0, 1, 1)
Referencia rápida de componentes
| Componente | Elemento Web | Variantes clave | Categoría |
|---|---|---|---|
| Botón | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Relleno, Contorneado, Texto, Elevado, Tonal; 5 tamaños (XS–XL); toggle | Acciones |
| Grupo de botones | md-button-group | Estándar, conectado | Acciones |
| FAB extendido | md-extended-fab | Superficie, Primario, Secundario, Terciario | Acciones |
| FAB | md-fab | Pequeño, Mediano, Grande | Acciones |
| Menú FAB | — | — | Acciones |
| Botón de icono | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Estándar, Relleno, Relleno Tonal, Contorneado | Acciones |
| Botón segmentado | — | Selección única, Selección múltiple | Acciones |
| Botón dividido | — | — | Acciones |
| Insignia | — | Pequeña (punto), Grande (conteo) | Comunicación |
| Indicador de carga | — | Lineal, Circular | Comunicación |
| Indicador de progreso | md-linear-progress, md-circular-progress | Lineal, Circular; determinista/indeterminista | Comunicación |
| Snackbar | — | Una línea, Dos líneas, Acción | Comunicación |
| Tooltip | — | Simple, Enriquecido | Comunicación |
| Tarjeta | — | Rellena, Contorneada, Elevada | Contención |
| Carrusel | — | Multinavegación, Sin contenedor, Heroico | Contención |
| Diálogo | md-dialog | Básico, Pantalla completa | Contención |
| Hoja inferior | — | Estándar, Modal | Hojas |
| Hoja lateral | — | Estándar, Modal | Hojas |
| Divisor | md-divider | Ancho completo, Insertado | Contención |
| Casilla de verificación | md-checkbox | — | Entrada |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Asistencia, Filtro, Entrada, Sugerencia | Entrada |
| Selector de fecha | — | Acoplado, Modal, Rango | Entrada |
| Menú | md-menu, md-menu-item | — | Entrada |
| Botón de opción | md-radio | — | Entrada |
| Deslizador | md-slider | Continuo, Discreto, Rango | Entrada |
| Interruptor | md-switch | Con/sin icono | Entrada |
| Campo de texto | md-filled-text-field, md-outlined-text-field | Relleno, Contorneado | Entrada |
| Selector de hora | — | Acoplado, Modal | Entrada |
| Barra de aplicación (superior) | — | Centrada, Pequeña, Mediana, Grande | Navegación |
| Barra de navegación | md-navigation-bar | — | Navegación |
| Panel de navegación | md-navigation-drawer | Estándar, Modal | Navegación |
| Riel de navegación | — | — | Navegación |
| Búsqueda | — | Barra de búsqueda, Vista de búsqueda | Navegación |
| Pestañas | md-tabs, md-primary-tab, md-secondary-tab | Primaria, Secundaria | Navegación |
| Barra de herramientas | — | — | Navegación |
| Lista | md-list, md-list-item | Una línea, Dos líneas, Tres líneas | Visualización de datos |
Nota: Los componentes marcados con — para elemento web no tienen implementaciones en @material/web todavía. Usa propiedades personalizadas CSS con HTML estándar para estos. Los mapeos y ejemplos de Compose se encuentran en references/component-catalog.md.
Detalles completos de componentes con ejemplos de código: references/component-catalog.md
Jetpack Compose (principal)
Usa androidx.compose.material3 con MaterialTheme y composables de Material 3 (Scaffold, Button, NavigationBar, barras de aplicación superiores, etc.).
- Tematización:
MaterialTheme(colorScheme = …, typography = …, shapes = …). PrefieredynamicLightColorScheme/dynamicDarkColorSchemeen Android 12+ (API 31+) cuando se desee color dinámico; de lo contrario,lightColorScheme/darkColorSchemeo código de tema generado desde Material Theme Builder. - UI adaptativa: Clases de tamaño de ventana, diseños de lista-detalle y panel de soporte, plegables — consulta
references/layout-and-responsive.mdyreferences/navigation-patterns.md. - Edge-to-edge e insets: Coloca el contenido con
WindowInsets/ relleno de scaffold para que las barras y el IME se comporten correctamente — consultareferences/layout-and-responsive.md. - APIs experimentales: Algunas APIs de Material 3 requieren
@OptIn(ExperimentalMaterial3Api::class)o opt-ins expresivos; asegúrate de que coincidan con tu BOM y compilador.
MaterialTheme(
colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
typography = Typography(),
shapes = Shapes(),
) {
// Contenido M3 — prefiere referencias para Scaffold, navegación, campos de texto
}
Web (limitado): @material/web
Importante: Según Material Design 3 para Web, los Material Web Components están en modo de mantenimiento y M3 Expressive no está implementado en Web. Usa @material/web para UIs basadas en tokens cuando sea apropiado, pero no lo trates como equivalente a Compose para las funciones expresivas actuales.
Configuración
npm install @material/web
Importar componentes individualmente
Siempre importa solo los componentes que usas — importar todo el paquete infla el bundle:
// Bien — importaciones individuales
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';
// Mal — nunca hagas esto
import '@material/web'; // importa todo
Uso básico
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
<md-filled-button>Comenzar</md-filled-button>
<md-outlined-text-field label="Correo electrónico" type="email"></md-outlined-text-field>
<script type="module">
import '@material/web/button/filled-button.js';
import '@material/web/textfield/outlined-text-field.js';
</script>
</body>
</html>
…
[truncado para traducción]