Tijolo por tijolo: ajude a criar o CSS Masonry

Patrick Brosset
Patrick Brosset
Alison Maher
Alison Maher

Publicado em: 23 de julho de 2025, última atualização: 13 de fevereiro de 2026

As equipes do Microsoft Edge e do Google Chrome têm o prazer de anunciar que o CSS masonry está pronto para testes iniciais de desenvolvedores no Chrome e no Edge 140.

Como ainda há problemas em aberto relacionados à especificação e à sintaxe do CSS Masonry, seu feedback é crucial para nos ajudar a definir o formato final da API. Teste o recurso e conte o que você achou.

Teste o CSS Masonry no Chromium hoje mesmo

Para testar o CSS Masonry hoje:

  1. Use o Chrome ou o Edge 140 ou mais recente (ou outro navegador baseado no Chromium com uma versão correspondente).
  2. Acesse about:flags em uma nova guia.
  3. Pesquise "CSS Masonry Layout".
  4. Ative a flag.
  5. Reinicie o navegador.
A entrada para Masonry na página de experimentos.

Com o recurso ativado, você pode conferir como ele funciona nas demonstrações do Microsoft Edge (confira o código-fonte das demonstrações) ou continue lendo para saber mais sobre o recurso e a sintaxe disponível.

O que é alvenaria?

O CSS Masonry é um modo de layout que permite criar uma disposição de itens semelhante a tijolos, de uma forma que não é facilmente alcançável com a grade CSS, o Flexbox ou o layout de colunas.

A alvenaria CSS pode ser usada para organizar itens em um formato de coluna ou linha, com itens colocados dentro dessas colunas ou linhas de maneira recolhida.

Itens organizados em layouts de alvenaria.

Pense na alvenaria como uma rodovia, em que a única restrição é o número e o tamanho das diferentes faixas de rodagem. Dentro das faixas, os veículos podem ter qualquer comprimento e estão sempre tentando ficar o mais perto possível do destino, que é o início do layout de alvenaria.

Demonstração usando veículos em fila nas faixas para mostrar o layout.

Os itens de layout são restritos apenas em uma direção e podem respirar livremente na outra, independentemente de outros itens próximos. O masonry é diferente da grade porque as faixas são definidas apenas em uma única direção.

No layout de alvenaria, a ordem visual dos itens é menos importante do que o design final. Com o Masonry, você aproveita ao máximo o espaço disponível, não importa quais itens você tenha. Isso o torna uma ótima opção para páginas com muitos elementos visuais e em que a ordem visual do conteúdo não importa tanto quanto o resultado final.

Um aspecto interessante da alvenaria é que ela também permite que os itens abranjam várias faixas, assim como na grade. Quando isso acontece, os itens continuam sendo colocados de uma maneira que preenche o máximo possível do espaço disponível.

A imagem com veículos, desta vez com veículos grandes em duas colunas.

Esse comportamento de posicionamento automático pode levar a resultados muito interessantes, que os web designers tentam alcançar há muito tempo. Por exemplo, confira a demonstração da galeria de fotos da cidade de Nova York, que mostra como as fotos podem ser exibidas de forma compacta em várias colunas, permitindo que determinados itens (o título neste exemplo) se estendam por várias colunas:

Uma galeria em que o título abrange colunas.

Confira alguns outros exemplos de como usar o layout de alvenaria.

Um layout de blog, mostrando a miniatura e a descrição de cada postagem.

Um site de notícias com alvenaria usada para cards de artigos.
Confira a demonstração do blog aqui.

Um site de notícias, em que os artigos aparecem em colunas, com alguns artigos mais largos do que outros, e as imagens principais abrangem toda a largura da página.

Um site de notícias em que alguns artigos abrangem colunas.
Confira a demonstração do novo Google Sites aqui.

Uma coleção de fotos, com diferentes tamanhos de coluna, e algumas fotos que abrangem várias colunas.

Layout em alvenaria de um site de fotografia.
Confira a demonstração de natureza aqui.

Soluções alternativas e limitações

Para implementar esse padrão de design na Web hoje, é necessário usar bibliotecas JavaScript ou soluções alternativas que usam grade CSS, flexbox ou várias colunas. No entanto, isso pode ter desvantagens, como:

  • Performance pior: depender de bibliotecas JavaScript ou de código personalizado para imitar o CSS Masonry tem desvantagens de performance, o que pode levar a experiências negativas do usuário.
  • Maior complexidade do código:
    • Garantir o posicionamento correto dos itens e a distribuição do espaço na grade CSS, no flexbox ou em várias colunas para imitar um layout de alvenaria CSS é difícil.
    • O processamento de recursos específicos, como itens que abrangem mais de uma coluna ou linha, a ordenação personalizada de itens ou o ajuste à janela de visualização, também pode levar a complexidade e limitações.
  • Maior carga de manutenção: códigos CSS ou JavaScript personalizados complexos são mais difíceis de manter.

A grade CSS é um modo de layout incrível e muito flexível que permite criar vários estilos de layout diferentes, seja para uma página da Web inteira, um componente ou apenas para alinhar itens individuais. No entanto, ele não tem as mesmas características da alvenaria.

Na grade CSS, as linhas e colunas são definidas de forma rígida, e os itens só podem existir nas células da grade. Se você estiver tentando empacotar itens ao longo de um dos eixos, mas os itens não forem dimensionados para caber nas respectivas células, será necessário escolher entre deixar lacunas entre os itens ou esticá-los para preencher o espaço vazio.

A grade coloca os itens em faixas fixas.

Assim como a alvenaria, o flexbox se preocupa apenas com uma direção e permite que os itens decidam o espaço que querem ocupar na outra direção. Isso significa que é possível criar um layout que se parece com um layout de alvenaria usando o flexbox, desde que você esteja satisfeito com os itens dispostos na direção do bloco, uma coluna por vez. O contêiner flexível também precisa de um tamanho de bloco ou altura definidos para que os itens se ajustem a uma nova linha flexível, criando uma nova coluna.

Layout flexível que ordena itens por coluna.

O layout de várias colunas também pode criar um layout que se parece com alvenaria, organizando os itens em colunas. Além disso, as várias colunas não permitem dimensionar cada uma delas de maneira diferente. Todos têm o mesmo tamanho, enquanto o masonry oferece muita flexibilidade para definir as faixas em que os itens são empacotados.

O importante aqui não é que a grade, o flexbox ou as várias colunas sejam layouts piores do que o masonry. Eles são ótimos tipos de layouts que têm muitos casos de uso. O ponto é: se você quer um layout de alvenaria, o CSS Masonry é o que vai oferecer isso.

O estado do CSS Masonry

O grupo de trabalho de CSS está elaborando o masonry na especificação CSS Grid Level 3. A especificação ainda está em construção e inclui temporariamente duas sintaxes propostas diferentes. O primeiro usa uma nova palavra-chave para a propriedade display, enquanto no segundo, o masonry é integrado diretamente ao layout de grade CSS.

Usar display: masonry

Essa sintaxe apresenta o CSS masonry como um tipo próprio de display. Mais detalhes sobre a abordagem e a motivação dela podem ser encontrados na postagem do blog Feedback needed: How should we define CSS masonry? (em inglês) da equipe do Google Chrome, bem como na seção restante desta postagem. O protótipo atual no Chromium é baseado nessa proposta.

display: grid; grid-template-*: masonry;

Nessa sintaxe, o CSS Masonry é integrado diretamente à grade CSS. O modo masonry é acionado aplicando a palavra-chave masonry à definição grid-template-columns no caso de um layout masonry baseado em linhas ou à definição grid-template-rows no caso de um layout masonry baseado em colunas.

Confira mais detalhes sobre essa proposta e a motivação dela na postagem do WebKit Ajude-nos a escolher a sintaxe final para Masonry no CSS.

Uma alternativa a essa proposta é a propriedade item-pack e a palavra-chave collapse, que acionariam o CSS Masonry em vez de usar uma das duas propriedades de modelo de grade.

Desde a publicação de postagens pelas equipes do Chrome e do WebKit, o CSSWG continuou as discussões sobre a sintaxe geral para avançar. Seu feedback pode ajudar a informar o desenvolvimento futuro nesses fóruns.

Para mais detalhes sobre o status atual das discussões, consulte o problema 11593, que descreve o conjunto atual de tópicos de discussão sobre a sintaxe de alvenaria, e o problema 11243 para um resumo do debate sobre a sintaxe até o momento.

Criar seu próprio layout de alvenaria CSS

Vamos nos divertir e criar um layout de alvenaria CSS.

Embora a sintaxe do CSS Masonry ainda esteja em discussão, nossa implementação do recurso pode ser testada no Chromium hoje mesmo. Basta ativar a flag de layout CSS Masonry, conforme explicado em Testar o CSS Masonry hoje. Os exemplos a seguir demonstram o que está disponível na prévia para desenvolvedores.

Criar um contêiner de alvenaria

Para criar seu primeiro contêiner de alvenaria baseado em colunas, use display:masonry e defina os tamanhos das colunas usando grid-template-columns. Como masonry-direction assume como padrão column, a definição dessa propriedade é opcional.

.masonry {
  display: masonry;
  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
  gap: 10px;
}
Layout de alvenaria em que todas as colunas têm o mesmo tamanho.
Confira aqui a demonstração de colunas do mesmo tamanho

Para um contêiner de alvenaria baseado em linhas, use display:masonry, defina os tamanhos das linhas usando grid-template-rows e, em seguida, defina masonry-direction:row.

.masonry {
 display: masonry;
 masonry-direction: row;
 grid-template-rows: repeat(auto-fit, minmax(160px, 1fr));
 gap: 10px;
}
Layout de alvenaria em que todas as linhas têm o mesmo tamanho.
Confira aqui a demonstração de linhas do mesmo tamanho

Como você deve ter notado, essa sintaxe é um pouco diferente da proposta original do Google. Independentemente do acionador usado para o CSS Masonry, o grupo de trabalho do CSS decidiu reutilizar as propriedades de dimensionamento e posicionamento do modelo de grade no layout do CSS Masonry.

Embora isso permita uma maior reutilização de propriedades entre os tipos de layout, pode ser confuso, e gostaríamos de saber sua opinião sobre o assunto. Podemos criar aliases mais genéricos para propriedades como grid-template-columns e grid-template-rows, como template-columns ou template-rows, que podem ser usados para grade e alvenaria.

Usar o tamanho padrão da faixa

Com um novo tipo de tela, surge a oportunidade de repensar os padrões de propriedade.

Na grade, grid-template-columns e grid-template-rows usam none como padrão, o que, conforme definido atualmente, normalmente resulta em uma única coluna ou linha. Para alvenaria, esse padrão geralmente resulta em um layout indesejável.

A implementação no Chromium adiciona a definição recém-proposta para none, que vai substituir o tamanho de faixa padrão no CSS Masonry. Esse novo tamanho de faixa padrão é o valor repeat(auto-fill, auto). Esse valor cria um layout de alvenaria agradável sem precisar definir tamanhos de faixa:

.masonry {
  display: masonry;
  gap: 10px;
}
Layout de alvenaria com colunas de tamanho automático.
Confira a demonstração do tamanho padrão da faixa aqui

Como mostrado na imagem, o contêiner de alvenaria cria quantas colunas de tamanho automático couberem no espaço disponível.

Com a grade CSS, todos os itens são colocados antes de as faixas serem dimensionadas, o que significa que essa definição de dimensionamento automático de faixas não é possível. No entanto, com o CSS Masonry, essa restrição não se aplica mais, já que o posicionamento e o dimensionamento estão interligados e simplificados. Com essa restrição removida, podemos fornecer um tamanho padrão de faixa mais útil para layouts de alvenaria.

Teste a propriedade abreviada masonry

Como mencionado antes, a implementação atual no Chromium depende das propriedades grid-template-* para definir a faixa de alvenaria no layout. No entanto, como a alvenaria tem apenas uma dimensão, também implementamos a propriedade abreviada masonry, que pode ser usada para definir a direção da alvenaria e a definição da faixa de uma só vez, sem a propriedade confusa com o prefixo grid-.

Por exemplo, os dois snippets de código a seguir criam contêineres de alvenaria CSS equivalentes.

.masonry {
 display: masonry;
 masonry: "a a b" 50px 100px 200px row;
}

.masonry {
  display: masonry;
  masonry-direction: row;
  grid-template-rows: 50px 100px 200px;
  grid-template-areas: "a" "a" "b"
}
Layout de alvenaria com três linhas que ficam progressivamente maiores.
Confira a demonstração da abreviação de alvenaria aqui

A abreviação masonry ainda está em discussão pelo grupo de trabalho do CSS. Faça um teste hoje mesmo e conte o que você achou.

Usar tamanhos de faixa personalizados

Quando se trata de definir tamanhos de faixas, a alvenaria é tão flexível quanto a grade, permitindo ajustar o número e os tamanhos das faixas de layout. As faixas de alvenaria também não precisam ter o mesmo tamanho, por exemplo:

.masonry {
 display: masonry;
 masonry: repeat(2, 3rem) repeat(auto-fit, 5rem) 12rem;
}
Layout de alvenaria com vários tamanhos de faixa diferentes.
Confira a demonstração de tamanhos de faixa personalizados aqui

Neste exemplo, estamos definindo duas primeiras faixas de 3rem, seguidas por um número variável de faixas de 5rem e, por fim, uma única faixa de 12rem.

Abranger várias faixas

No layout de alvenaria, os itens não precisam ser restritos às faixas em que são colocados, já que podem abranger várias faixas, se necessário. Isso pode ser muito útil quando alguns itens são mais importantes do que outros e exigem mais espaço.

Exemplo:

.masonry {
  display: masonry;
  masonry: repeat(auto-fill, minmax(12rem, 1fr));
}

.important-item {
  grid-column: span 2;
}
Layout de alvenaria com itens que abrangem várias faixas.
Confira aqui a demonstração de várias faixas

Você também pode usar essa capacidade de abranger várias faixas para que determinados itens ocupem todo o comprimento do contêiner:

.masonry {
 display: masonry;
 masonry: repeat(auto-fill, minmax(12rem, 1fr));
}

.full-bleed {
 grid-column: 1 / -1;
}

É isso que a demonstração do site de notícias usa para mostrar o anúncio de assinatura nos artigos.

Layout de site de notícias com um banner que abrange toda a área.

Ajuste do posicionamento de itens em alvenaria

No CSS Masonry, os itens são colocados na coluna ou linha que tem a menor posição de execução.

Imagine um contêiner de alvenaria de duas colunas. Se o contêiner tiver um item de 110 px de altura na primeira coluna e um item de 100 px de altura na segunda, um terceiro item será colocado na segunda coluna, onde ficará 10 px mais próximo do início da direção da alvenaria.

Um layout em alvenaria de duas colunas.

Se você considerar que uma diferença de 10 px na posição de execução é pequena o suficiente para seu caso e preferir que o terceiro item seja colocado na primeira coluna, para corresponder melhor à ordem de origem, use a propriedade item-tolerance.

A nova propriedade item-tolerance controla a sensibilidade na colocação de itens.

No exemplo anterior, é possível aplicar item-tolerance: 10px; ao contêiner para personalizar a variabilidade no posicionamento do item:

.masonry {
  display: masonry;
  masonry: 200px 200px;
  gap: 10px;
  item-tolerance: 10px;
}
Um layout de alvenaria de duas colunas.
Confira a demonstração da tolerância de itens aqui

Observe que o rascunho da especificação chama essa propriedade de item-slack. O grupo de trabalho do CSS decidiu recentemente usar item-tolerance como o nome, e a especificação será atualizada em breve.

Outras propriedades disponíveis

É possível usar as mesmas propriedades de dimensionamento e posicionamento de modelo para dimensionar e posicionar itens no eixo de grade de um contêiner de alvenaria, como é possível fazer com a grade CSS, como grid-row, grid-column, grid-area, grid-template-areas ou order. Aproveite todo o poder da grade CSS ao criar seu layout de alvenaria.

Solicitação de feedback

Mal podemos esperar para que você explore o CSS Masonry, use sua criatividade e descubra os novos recursos que ele pode ajudar você a desbloquear. Uma ótima maneira de começar é conferir nossas demonstrações e o código-fonte delas e começar a criar seus próprios exemplos no Chromium. Lembre-se de ativar a flag primeiro.

Seu feedback é importante para nos ajudar a moldar a API e verificar se ela foi projetada para atender às suas necessidades na Web. Teste o layout de alvenaria e conte para nós o que você achou.

Se você tiver ideias ou feedback sobre o formato da API, deixe um comentário no problema 11243. Se preferir escrever um post no seu próprio blog ou nas redes sociais, entre em contato pelo X ou pelo LinkedIn.

A alvenaria CSS ainda está sendo implementada no Chromium. Se você testar, saiba que ainda estamos trabalhando ativamente nele e que você pode encontrar casos em que ele não se comporta como esperado. Algumas das limitações atuais incluem empacotamento denso, posicionamento reverso, suporte a subgrade, suporte fora de fluxo, suporte de referência, suporte ao DevTools, suporte à fragmentação, suporte à decoração de lacunas, entre outros.

Se você encontrar um bug ao testar o recurso, compartilhe seu feedback abrindo um novo bug do Chromium.