La API de Grid de Jetpack Compose está diseñada para diseños de pantalla estructurales y bidimensionales. A diferencia de las cuadrículas diferidas, que están optimizadas para conjuntos de datos grandes, Grid te permite definir una estructura de diseño fija o responsiva con pistas (filas y columnas), espacios y áreas de cuadrícula. Los elementos se colocan en esta estructura con Modifier.gridItem, lo que te brinda un control explícito sobre el posicionamiento y la extensión dentro del contenedor de cuadrícula.
Cuando tu IU requiere varios elementos en la misma área de cuadrícula o áreas superpuestas, como superposiciones de insignias, indicadores de estado o tarjetas en capas, la ambigüedad de las coordenadas puede hacer que el comportamiento del diseño sea impredecible. Administrar la profundidad de los componentes superpuestos sin recurrir a un anidamiento complejo de Box ni a compensaciones de coordenadas manuales es esencial para mantener un código de diseño limpio y legible.
Prácticas recomendadas
- Orden de declaración:
Gridsigue el orden estándar dezIndexsegún el orden de declaración dentro del bloqueGrid. Los elementos que se declaran más adelante en el bloque de contenidoGridse renderizan sobre los elementos que se declaran antes. - Control explícito del índice z: Usa
Modifier.zIndexsi necesitas controlar o anular de forma explícita el orden de dibujo predeterminado de los elementos superpuestos. - Área con nombre frente a superposiciones de elementos: Usa
Gridy áreas con nombre para definir la estructura de tu diseño, pero mantén la lógica de superposición compleja dentro delgridItemespecífico si esas superposiciones están vinculadas lógicamente a esa celda de la cuadrícula. - Intervalos intencionales para las superposiciones: Cuando realices una superposición, asegúrate de que los parámetros
rowSpanycolumnSpansean intencionales para que los elementos superpuestos controlen qué parte del contenido subyacente se oculta.
Ingredientes
Grid: Es un contenedor de diseño estructural bidimensional.GridConfigurationScope.area: Es la función de alcance que se usa para definir regiones con nombre y áreas de superposición en las pistas de cuadrícula.Modifier.gridItem: Es el modificador que se usa para colocar y extender elementos componibles en pistas de cuadrícula o en áreas de cuadrícula con nombre.Modifier.zIndex: Es el modificador que se usa para controlar de forma explícita el orden de elevación de las capas y los dibujos.
Pasos
Configura el diseño de cuadrícula y las áreas con nombre, posiciona el contenido de la capa base dentro de las coordenadas de la cuadrícula de destino y coloca los elementos de superposición en las celdas de la cuadrícula compartidas o en las áreas superpuestas.
1. Define la configuración de la cuadrícula
Crea una configuración de componible Grid que especifique pistas de filas y columnas, así como áreas con nombre que abarquen celdas para definir regiones de superposición:
enum class Areas { BASE, OVERLAY } val gridConfig: GridConfigurationScope.() -> Unit = { repeat(3) { column(GridTrackSize.Fixed(100.dp)) } row(GridTrackSize.Fixed(100.dp)) area(areaId = Areas.BASE, row = 1, column = 1, columnSpan = 2) // Define a named area spanning multiple columns that overlaps other cells area(areaId = Areas.OVERLAY, row = 1, column = 2, columnSpan = 2) }
2. Coloca el contenido base y declara las superposiciones
Coloca tus elementos componibles de base en las celdas de la cuadrícula con Modifier.gridItem. Grid sigue el orden estándar de zIndex según el orden de composición, por lo que los elementos declarados más adelante dentro del bloque Grid se dibujan sobre los elementos anteriores. Cuando coloques una superposición en la misma celda o en un área superpuesta, declara el elemento de componibilidad de superposición después del elemento base o haz referencia a un área con nombre. Puedes usar Modifier.zIndex si necesitas controlar o anular de forma explícita este orden de dibujo predeterminado.
Grid( config = gridConfig, ) { // Base Layer TextCard("BASE", Modifier.gridItem(areaId = Areas.BASE)) // Overlay Layer TextCard( "OVERLAY", Modifier.gridItem(areaId = Areas.OVERLAY), color = Color(0xDD4B608D) ) }
Resultados
Los elementos de la IU se superponen de forma predecible dentro de la estructura de cuadrícula 2D. Si confías en el orden de declaración estándar, evitas los contenedores anidados complejos y, al mismo tiempo, mantienes un código de diseño limpio y responsivo.