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:
Gridsegue a ordem padrão dezIndexcom base na ordem de declaração no blocoGrid. Os itens declarados posteriormente no bloco de conteúdoGridsão renderizados sobre os itens declarados anteriormente. - Controle explícito do índice z:use
Modifier.zIndexse precisar controlar ou substituir explicitamente a ordem de desenho padrão de elementos sobrepostos. - Área nomeada x sobreposições de itens:use
Gride áreas nomeadas para definir a estrutura do layout, mas mantenha a lógica de sobreposição complexa dentro dogridItemespecí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
rowSpanecolumnSpansã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.