Superposiciones de elementos de la IU con cuadrícula

Ícono de calificación de cuatro estrellas

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: Grid sigue el orden estándar de zIndex según el orden de declaración dentro del bloque Grid. Los elementos que se declaran más adelante en el bloque de contenido Grid se renderizan sobre los elementos que se declaran antes.
  • Control explícito del índice z: Usa Modifier.zIndex si 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 Grid y áreas con nombre para definir la estructura de tu diseño, pero mantén la lógica de superposición compleja dentro del gridItem especí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 rowSpan y columnSpan sean 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.

Diseño de cuadrícula que muestra elementos de la IU superpuestos
Figura 1: Elementos de la IU superpuestos dentro de una cuadrícula de Compose