Sobreposições de elementos da interface com grade

Ícone de avaliação de quatro estrelas

A API Grid do Jetpack Compose foi projetada para layouts de tela estruturais e bidimensionais. Ao contrário das grades lentas, que são otimizadas para grandes conjuntos de dados, o Grid permite definir uma estrutura de layout fixa ou responsiva usando faixas (linhas e colunas), lacunas e áreas de grade. Você coloca itens nessa estrutura usando Modifier.gridItem, que oferece controle explícito sobre o posicionamento e a extensão no contêiner de grade.

Quando a interface exige vários itens na mesma área de grade ou em áreas sobrepostas, como sobreposições de selos, indicadores de status ou cards em camadas, a ambiguidade de coordenadas pode tornar o comportamento do layout imprevisível. Gerenciar a profundidade de componentes sobrepostos sem recorrer a aninhamentos complexos de Box ou deslocamentos manuais de coordenadas é essencial para manter um código de layout limpo e legível.

Práticas recomendadas

  • Ordem de declaração:Grid segue a ordem padrão de zIndex com base na ordem de declaração no bloco Grid. Os itens declarados posteriormente no bloco de conteúdo Grid são renderizados sobre os itens declarados anteriormente.
  • Controle explícito do índice z:use Modifier.zIndex se precisar controlar ou substituir explicitamente a ordem de desenho padrão de elementos sobrepostos.
  • Área nomeada x sobreposições de itens:use Grid e áreas nomeadas para definir a estrutura do layout, mas mantenha a lógica de sobreposição complexa dentro do gridItem específico se essas sobreposições estiverem logicamente vinculadas a essa célula da grade.
  • Períodos intencionais para sobreposições:ao sobrepor, verifique se os parâmetros rowSpan e columnSpan são intencionais para que os elementos sobrepostos controlem quanto do conteúdo subjacente é ocultado.

Ingredientes

  • Grid: um contêiner de layout estrutural bidimensional.
  • GridConfigurationScope.area: função de escopo usada para definir regiões nomeadas e sobrepor áreas em faixas de grade.
  • Modifier.gridItem: modificador usado para posicionar e estender elementos que podem ser compostos em faixas de grade ou em áreas de grade nomeadas.
  • Modifier.zIndex: modificador usado para controlar explicitamente a ordem de elevação do desenho e da camada.

Etapas

Configure o layout de grade e as áreas nomeadas, posicione o conteúdo da camada de base nas coordenadas de grade de destino e coloque os elementos de sobreposição nas células de grade compartilhadas ou nas áreas de sobreposição.

1. Definir a configuração da grade

Crie uma configuração combinável Grid especificando faixas de linhas e colunas, bem como áreas nomeadas que abrangem células para definir regiões de sobreposição:

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. Colocar o conteúdo de base e declarar as sobreposições

Coloque os elementos combináveis de base nas células da grade usando Modifier.gridItem. Grid segue a ordenação padrão de zIndex com base na ordem de composição. Assim, os itens declarados posteriormente no bloco Grid são renderizados sobre os itens anteriores. Ao colocar uma sobreposição na mesma célula ou em uma área de sobreposição, declare o elemento de sobreposição após o elemento de base ou faça referência a uma área nomeada. Use Modifier.zIndex se precisar controlar ou substituir explicitamente essa ordem de desenho padrão.

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

Os elementos da interface se sobrepõem de forma previsível na estrutura de grade 2D. Ao depender da ordenação de declaração padrão, você evita contêineres aninhados complexos e mantém um código de layout limpo e responsivo.

Layout de grade mostrando elementos da interface sobrepostos
Figura 1. Elementos da interface sobrepostos em uma grade do Compose.