Directrices de Diseño para la Plataforma Android — Material Design 3
1. Material You y Temas [CRÍTICO]
1.1 Color Dinámico
Habilita el color dinámico derivado del fondo de pantalla del usuario. El color dinámico es el valor predeterminado en Android 12 y debe ser la estrategia principal de tematización.
// Compose: Tema de color dinámico
@Composable
fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
dynamicColor: Boolean = true,
content: @Composable () -> Unit
) {
val colorScheme = when {
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
val context = LocalContext.current
if (darkTheme) dynamicDarkColorScheme(context)
else dynamicLightColorScheme(context)
}
darkTheme -> darkColorScheme()
else -> lightColorScheme()
}
MaterialTheme(
colorScheme = colorScheme,
typography = AppTypography,
content = content
)
}
<!-- XML: Color dinámico en themes.xml -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
<item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>
Reglas:
- R1.1: Siempre proporciona un esquema de color estático de respaldo para dispositivos con Android 11 o inferior.
- R1.2: Nunca uses valores hexadecimales de color directamente en los componentes. Siempre referencia los roles de color del tema.
- R1.3: Prueba con al menos 3 fondos de pantalla diferentes para verificar la armonía del color dinámico.
1.2 Roles de Color
Material 3 define un conjunto estructurado de roles de color. Úsalos de forma semántica, no estética.
| Rol | Uso | Sobre-rol |
|---|---|---|
primary | Acciones clave, estados activos, FAB | onPrimary |
primaryContainer | Elementos primarios menos prominentes | onPrimaryContainer |
secondary | IU de soporte, chips de filtro | onSecondary |
secondaryContainer | Indicador activo de la barra de navegación | onSecondaryContainer |
tertiary | Acento, contraste, complementario | onTertiary |
tertiaryContainer | Campos de entrada, acentos menos prominentes | onTertiaryContainer |
surface | Fondos, tarjetas, hojas | onSurface |
surfaceVariant | Elementos decorativos, divisores | onSurfaceVariant |
error | Estados de error, acciones destructivas | onError |
errorContainer | Fondos de error | onErrorContainer |
outline | Bordes, divisores | — |
outlineVariant | Bordes sutiles | — |
inverseSurface | Fondo de Snackbar | inverseOnSurface |
// Correcto: roles de color semánticos
Text(
text = "Mensaje de error",
color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
Text(text = "Detalle del error", color = MaterialTheme.colorScheme.onErrorContainer)
}
// INCORRECTO: colores fijos
Text(text = "Error", color = Color(0xFFB00020)) // Anti-patrón
Reglas:
- R1.4: Cada elemento de primer plano debe usar el rol de color
oncorrespondiente a su fondo (por ejemplo, textoonPrimarysobre fondoprimary). - R1.5: Usa
surfacey sus variantes para fondos. Nunca usesprimaryosecondarycomo áreas de fondo grandes. - R1.6: Usa
tertiarycon moderación, solo para acento y contraste complementario.
1.3 Temas Claro y Oscuro
Ofrece soporte tanto para tema claro como oscuro. Respeta la configuración del sistema de forma predeterminada.
// Compose: Detectar tema del sistema
val darkTheme = isSystemInDarkTheme()
Reglas:
- R1.7: Siempre ofrece soporte para temas claro y oscuro. Nunca publiques solo claro.
- R1.8: Las superficies del tema oscuro usan mapeo tonal basado en elevación, no negro puro (#000000). Usa los roles de color
surfaceque manejan esto automáticamente. - R1.9: Proporciona una anulación manual del tema en la configuración de la aplicación (Sistema / Claro / Oscuro).
1.4 Colores Personalizados Semilla
Cuando la marca requiera colores personalizados, proporciona un color semilla y genera paletas tonales usando Material Theme Builder.
// Esquema de color personalizado con semilla de marca
private val BrandLightColorScheme = lightColorScheme(
primary = Color(0xFF1B6D2F),
onPrimary = Color(0xFFFFFFFF),
primaryContainer = Color(0xFFA4F6A8),
onPrimaryContainer = Color(0xFF002107),
// ... generar paleta completa a partir de la semilla
)
Reglas:
- R1.10: Genera paletas tonales a partir de colores semilla usando Material Theme Builder. Nunca selecciones tonos individuales manualmente.
- R1.11: Al usar colores personalizados, sigue soportando el color dinámico como predeterminado y usa los colores personalizados como respaldo.
2. Navegación [CRÍTICO]
2.1 Barra de Navegación (Inferior)
El patrón de navegación principal para teléfonos con 3-5 destinos de nivel superior.
// Compose: Barra de navegación
NavigationBar {
items.forEachIndexed { index, item ->
NavigationBarItem(
icon = {
Icon(
imageVector = if (selectedItem == index) item.filledIcon else item.outlinedIcon,
contentDescription = item.label
)
},
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
Reglas:
- R2.1: Usa la Barra de Navegación para 3-5 destinos de nivel superior en pantallas compactas. Nunca uses menos de 3 o más de 5.
- R2.2: Siempre muestra etiquetas en los elementos de la barra de navegación. No se permiten barras de navegación solo con íconos.
- R2.3: Usa íconos rellenos para el estado seleccionado e íconos delineados para los no seleccionados.
- R2.4: El indicador activo usa el color
secondaryContainer. No lo anules.
2.2 Rail de Navegación
Para pantallas medianas y expandidas (tablets, plegables, escritorio).
// Compose: Rail de navegación para pantallas grandes
NavigationRail(
header = {
FloatingActionButton(
onClick = { /* acción principal */ },
containerColor = MaterialTheme.colorScheme.tertiaryContainer
) {
Icon(Icons.Default.Add, contentDescription = "Crear")
}
}
) {
items.forEachIndexed { index, item ->
NavigationRailItem(
icon = { Icon(item.icon, contentDescription = item.label) },
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
Reglas:
- R2.5: Usa el Rail de Navegación en tamaños de ventana medianos (600-839dp) y expandidos (840dp+). Combínalo con la Barra de Navegación en compacto.
- R2.6: Opcionalmente, incluye un FAB en el encabezado del rail para la acción principal.
- R2.7: Las etiquetas son opcionales en el rail, pero se recomiendan para mayor claridad.
2.3 Cajón de Navegación
Para 5 o más destinos o jerarquías de navegación complejas, típicamente en pantallas expandidas.
// Compose: Cajón de navegación permanente para pantallas grandes
PermanentNavigationDrawer(
drawerContent = {
PermanentDrawerSheet {
Text("Nombre de la App", modifier = Modifier.padding(16.dp),
style = MaterialTheme.typography.titleMedium)
HorizontalDivider()
items.forEach { item ->
NavigationDrawerItem(
label = { Text(item.label) },
selected = item == selectedItem,
onClick = { selectedItem = item },
icon = { Icon(item.icon, contentDescription = null) }
)
}
}
}
) {
Scaffold { /* contenido de la página */ }
}
Reglas:
- R2.8: Usa el cajón modal en pantallas compactas y el cajón permanente en pantallas expandidas.
- R2.9: Agrupa los elementos del cajón en secciones con divisores y encabezados de sección.
2.4 Gesto de Retroceso Predictivo
Android 13+ admite retroceso predictivo con una vista previa de animación.
// Compose: Retroceso predictivo con BackHandler (androidx.activity.compose)
BackHandler(enabled = true) {
// Se llama cuando se confirma el retroceso; navega hacia atrás en tu controlador de navegación
navController.popBackStack()
}
// Compose: Animación de progreso de retroceso predictivo usando el modificador predictiveBackHandler
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
// progress es un Flow<BackEventCompat> con x, y, swipeEdge, progress (0.0–1.0)
progress.collect { backEvent ->
animationState = backEvent.progress
}
}
<!-- AndroidManifest.xml: optar por retroceso predictivo -->
<application android:enableOnBackInvokedCallback="true">
Reglas:
- R2.10: Opta por el retroceso predictivo en el manifiesto. En aplicaciones Compose, usa
BackHandler(deandroidx.activity.compose) para interceptar eventos de retroceso. En aplicaciones basadas en vistas, implementaOnBackInvokedCallback(API 33+) oOnBackPressedCallback(AndroidX) en lugar de anularonBackPressed(). - R2.11: El gesto de retroceso del sistema navega hacia atrás en la pila de navegación. El botón Arriba (flecha de la barra de herramientas) navega hacia arriba en la jerarquía de la aplicación. Estos pueden diferir.
- R2.12: Nunca interceptes el retroceso del sistema para mostrar diálogos de "¿estás seguro?" a menos que haya entrada de usuario sin guardar.
- R2.13: No suprimas la animación de vista previa de retroceso proporcionada por el sistema. Si implementas transiciones de entrada/salida personalizadas, interpólalas usando
BackEventCompat.progress(0.0–1.0) y respetaBackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT) para que la pantalla que sale se reduzca y se desplace hacia el borde de inicio, coincidiendo con la animación del sistema. - R2.14: Prefiere reconocimiento sobre recuerdo. Mantén los destinos etiquetados, el estado seleccionado visible y el contexto de la pila de retroceso preservado para que los usuarios no tengan que reconstruir dónde están después de cada paso de navegación.
// Compose: animar una transición personalizada desde el progreso de retroceso predictivo
Modifier.predictiveBackHandler(enabled = true) { progress ->
progress.collect { backEvent ->
// backEvent.progress: 0.0 (inicio del gesto) → 1.0 (confirmado)
// backEvent.swipeEdge: BackEventCompat.EDGE_LEFT o EDGE_RIGHT
exitScale = 1f - (backEvent.progress * 0.1f)
exitOffsetX = if (backEvent.swipeEdge == BackEventCompat.EDGE_LEFT) -backEvent.progress * 32.dp.toPx() else backEvent.progress * 32.dp.toPx()
}
}
2.5 Selección del Componente de Navegación
| Tamaño de Pantalla | 3-5 Destinos | 5+ Destinos |
|---|---|---|
| Compacto (< 600dp) | Barra de Navegación | Cajón Modal + Barra de Navegación |
| Medio (600-839dp) | Rail de Navegación | Cajón Modal + Rail de Navegación |
| Expandido (840dp+) | Rail de Navegación | Cajón Permanente |
3. Diseño y Responsividad [ALTA]
3.1 Clases de Tamaño de Ventana
Usa clases de tamaño de ventana para diseños adaptativos, no puntos de interrupción de píxeles fijos.
// Compose: Clases de tamaño de ventana
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
WindowWidthSizeClass.Compact -> CompactLayout()
WindowWidthSizeClass.Medium -> MediumLayout()
WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
| Clase | Ancho | Dispositivo Típico | Columnas |
|---|---|---|---|
| Compacto | < 600dp | Teléfono en vertical | 4 |
| Medio | 600-839dp | Tablet en vertical, plegable | 8 |
| Expandido | 840dp+ | Tablet en horizontal, escritorio | 12 |
Reglas:
- R3.1: Siempre usa
WindowSizeClassdematerial3-window-size-classpara decisiones de diseño responsivo. - R3.2: Nunca uses puntos de interrupción de píxeles fijos. Las categorías de dispositivos son fluidas.
- R3.3: Soporta las tres clases de tamaño de ancho. Como mínimo, compacto y expandido.
3.2 Cuadrícula de Material
Aplica los márgenes y medianiles canónicos de la cuadrícula de Material.
| Clase de Tamaño | Márgenes | Medianiles | Columnas |
|---|---|---|---|
| Compacto | 16dp | 8dp | 4 |
| Medio | 24dp | 16dp | 8 |
| Expandido | 24dp | 24dp | 12 |
Reglas:
- R3.4: El contenido no debe ocupar todo el ancho en pantallas expandidas. Usa un ancho máximo de contenido de ~840dp o un diseño de lista-detalle.
- R3.5: Aplica márgenes horizontales consistentes que coincidan con la especificación de la cuadrícula.
3.3 Pantalla de Borde a Borde
Android 15+ exige pantalla de borde a borde. Todas las aplicaciones deben dibujar detrás de las barras del sistema.
// Compose: Configuración de borde a borde
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
Scaffold(
modifier = Modifier.fillMaxSize(),
// Scaffold maneja los insets para las barras superior e inferior automáticamente
) { innerPadding ->
Content(modifier = Modifier.padding(innerPadding))
}
}
}
}
Reglas:
- R3.6: Llama a
enableEdgeToEdge()antes desetContent. Dibuja detrás de la barra de estado y la barra de navegación. - R3.7: Usa
WindowInsetspara separar el contenido de las barras del sistema.Scaffoldmaneja esto automáticamente para el contenido de la barra superior e inferior. - R3.8: El contenido desplazable debe desplazarse detrás de las barras del sistema transparentes con el relleno de inset adecuado en la parte superior e inferior de la lista.
3.4 Soporte para Dispositivos Plegables
// Compose: Detectar postura del plegable
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
.windowLayoutInfo(context)
.collectAsState(initial = WindowLayoutInfo(emptyList()))
Reglas:
- R3.9: Detecta la posición de la bisagra/pliegue y evita colocar contenido crítico a través del pliegue.
- R3.10: Usa
ListDetailPaneScaffoldoSupportingPaneScaffoldde la biblioteca adaptativa de Material3 para diseños compatibles con plegables.
4. Tipografía [ALTA]
4.1 Escala de Tipo de Material
| Rol | Tamaño Predeterminado | Peso Predeterminado | Uso |
|---|---|---|---|
| displayLarge | 57sp | 400 | Texto principal, incorporación |
| displayMedium | 45sp | 400 | Texto de características grandes |
| displaySmall | 36sp | 400 | Visualización prominente |
| headlineLarge | 32sp | 400 | Títulos de pantalla |
| headlineMedium | 28sp | 400 | Encabezados de sección |
| headlineSmall | 24sp | 400 | Títulos de tarjeta |
| titleLarge | 22sp | 400 | Título de la barra de aplicación superior |
| titleMedium | 16sp | 500 | Pestañas, navegación |
| titleSmall | 14sp | 500 | Subtítulos |
| bodyLarge | 16sp | 400 | Texto del cuerpo principal |
| bodyMedium | 14sp | 400 | Texto del cuerpo secundario |
| bodySmall | 12sp | 400 | Leyendas |
| labelLarge | 14sp | 500 | Botones, etiquetas prominentes |
| labelMedium | 12sp | 500 | Chips |
... [truncado para la traducción]