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:
- Use o Chrome ou o Edge 140 ou mais recente (ou outro navegador baseado no Chromium com uma versão correspondente).
- Acesse
about:flagsem uma nova guia. - Pesquise "CSS Masonry Layout".
- Ative a flag.
- Reinicie o navegador.
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.
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.
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.
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:
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, 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.
Uma coleção de fotos, com diferentes tamanhos de coluna, e algumas fotos que abrangem várias colunas.
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.
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.
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;
}
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;
}
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;
}
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"
}
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;
}
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;
}
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.
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.
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;
}
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.