Se você já pensa em linhas e colunas, continue assim. O tw-bootstrap-grid traz para o Tailwind o conhecido grid de 12 colunas, com .row, .col-6, .offset-2 e .g-4, com suporte a RTL e sem opinar sobre como seus componentes devem ser.
.row, .col, .col-auto e de .col-1 a .col-12, exatamente como no Bootstrap.
Gutters do seu tema
.g-*, .gx-* e .gy-* usam a escala de espaçamento do Tailwind, então combinam com o resto do seu design.
Offsets
De .offset-0 a .offset-12 para centralizar uma coluna ou deixar um espaço.
Colunas por linha
De .row-cols-1 a .row-cols-6 e .row-cols-auto dimensionam todos os filhos com uma única classe na linha.
Contêineres
.container e .container-fluid com preenchimento que considera o gutter. As larguras máximas vêm dos breakpoints do próprio Tailwind.
Responsivo e RTL
Toda classe aceita os prefixos de breakpoint do Tailwind, como md:col-6, e se inverte corretamente com dir="rtl".
Ele cuida apenas do layout: sem cores, sem componentes, sem resets. Ele acrescenta ao Tailwind em vez de substituir qualquer coisa, então você pode misturar col-4 e flex na mesma página sem pensar duas vezes.
Primeiros passos
Instalação
Três passos: instale o pacote, registre o plugin e comece a usar as classes.
1Instale o pacote
npm install tw-bootstrap-grid
2Registre o plugin
Escolha sua versão do Tailwind no cabeçalho e o trecho abaixo acompanha. O Tailwind v4 registra plugins no CSS, o v3 no arquivo de configuração.
O plugin roda dentro do compilador do Tailwind (PostCSS, Vite, Webpack, a CLI do Tailwind…). Ele não funciona com o script Tailwind Play CDN, que não consegue carregar plugins do npm.
Primeiros passos
Configuração
Os valores padrão são os mesmos do Bootstrap, então você pode pular esta página. Volte quando quiser outros breakpoints ou tamanhos de gutter.
Breakpoints
O plugin não tem breakpoints próprios. Prefixos como md:col-6 e a largura máxima de .container vêm do Tailwind, então mudar suas telas muda o grid junto.
Gutters são o espaço entre as colunas. Por padrão são 1.5rem na horizontal e 0 na vertical. Defina uma vez para tudo, ou separadamente para contêineres e linhas. No v3 você passa opções ao plugin, no v4 você define variáveis CSS.
Tailwind v4
main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";
:root {
/* used by containers and rows */
--bs-global-gutter-x: 1.5rem;
--bs-global-gutter-y: 0;
/* overrides for one of them only */
--bs-container-gutter-x: 1rem;
--bs-row-gutter-x: 2rem;
--bs-row-gutter-y: 1rem;
}
Ordem de resolução do gutter
Prioridade
Variável CSS
Opção
Observações
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
O valor mais específico vence.
2
--bs-global-gutter-x
gutters
Valor de reserva compartilhado pelos dois.
3
1.5rem (x) e 0 (y)
padrão embutido
Os mesmos padrões que o Bootstrap usa.
As variáveis CSS são lidas em tempo de execução, então em qualquer uma das versões você também pode sobrescrevê-las em qualquer elemento para mudar os gutters só daquela seção. Para uma única linha, use .g-*, .gx-* e .gy-*.
Desative os contêineres
Prefere usar só o container do Tailwind? Defina generateContainers como false e o plugin para de gerar .container-fluid e o preenchimento que considera o gutter. Linhas e colunas não são afetadas.
O Tailwind v4 consegue passar valores simples como generateContainers: false; a um plugin, mas não objetos aninhados como gutters. As variáveis CSS cobrem esse caso e ainda podem ser sobrescritas por elemento.
Referência
Classes
Tudo o que o plugin adiciona, em um só lugar.
Layout
Classes de Layout
Classe
O que faz
Observações
.container
width: 100%; centralizado; preenchimento conforme o gutter
A largura máxima vem dos breakpoints do Tailwind.
.container-fluid
igual a .container
Largura total em todos os breakpoints.
.row
display: flex; flex-wrap: wrap; margens negativas
Anula o gutter externo e organiza seus filhos.
Colunas
Classes de Colunas
Classe
O que faz
Observações
.col
flex: 1 0 0%
Divide o espaço restante igualmente.
.col-auto
flex: 0 0 auto; width: auto
Dimensionada pelo conteúdo.
.col-1 … .col-12
flex: 0 0 auto; width: n / 12
Ocupa n de 12 partes.
Offsets e colunas por linha
Classes de Offsets e colunas por linha
Classe
O que faz
Observações
.offset-0 … .offset-12
margin-inline-start: n / 12
Se inverte automaticamente em RTL.
.row-cols-1 … .row-cols-6
os filhos recebem width: 1 / n
Definida na .row, vale para todos os filhos.
.row-cols-auto
os filhos recebem width: auto
Os filhos são dimensionados pelo conteúdo.
Gutters
Classes de Gutters
Classe
O que faz
Observações
.g-*
--bs-gutter-x e --bs-gutter-y
As duas direções.
.gx-*
--bs-gutter-x
Somente horizontal.
.gy-*
--bs-gutter-y
Somente vertical.
Tudo é responsivo
Adicione um prefixo de breakpoint a qualquer classe acima: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.
Quais degraus de gutter existem?
.g-*, .gx-* e .gy-* são geradas a partir do seu tema de espaçamento. No v3, é cada chave de theme.spacing sem ponto (então g-4 sim, g-0.5 não). No v4, é a escala padrão, de g-0 a g-96 e g-px.
Alinhamento e ordem vêm do Tailwind
O plugin não traz seus próprios justify-*, items-* ou order-*. Uma .row é um contêiner flex comum, então as utilitárias do Tailwind funcionam diretamente nela.
Vindo do Bootstrap
Migrando do Bootstrap
O grid funciona do jeito que você lembra. Três coisas parecem diferentes: como as classes responsivas são escritas, os números de espaçamento e as larguras dos breakpoints.
O que continua igual
A estrutura: .container, .row, .col-*, .offset-*, .row-cols-*. Até as variáveis CSS mantêm os nomes, --bs-gutter-x e --bs-gutter-y, então o CSS próprio que as lê continua funcionando.
Prefixo, não infixo
O Bootstrap escreve col-md-6. O Tailwind escreve md:col-6. É a mudança que você mais vai tocar, e um script pode fazê-la por você.
Números diferentes
Os números de gutter e de espaçamento seguem a escala do Tailwind, então o g-3 do Bootstrap é g-4 aqui. As larguras dos breakpoints também diferem um pouco.
O guia completo tem as tabelas de equivalência, as mudanças nos tamanhos de gutter, como igualar os breakpoints do Bootstrap e um comando que converte seu código.
Todo exemplo é interativo. Edite o HTML à esquerda e a pré-visualização é atualizada enquanto você digita. Se você conhece o grid do Bootstrap (abre em uma nova aba), vai parecer familiar.
Um layout básico
Um .container centraliza seu conteúdo, uma .row alinha as colunas lado a lado e cada .col-* ocupa essa quantidade das 12 partes disponíveis. Duas colunas col-6 dividem a linha ao meio.
Pré-visualização
HTML editável
As colunas sempre quebram de linha. O que passar de 12 partes em uma linha desce para a próxima, o que é útil para listas de cards.
Colunas iguais e de largura automática
Um .col simples divide o espaço que sobrar, então três delas são três colunas iguais. .col-auto se dimensiona pelo conteúdo e o .col vizinho fica com o resto.
Pré-visualização
HTML editável
Colunas responsivas
Toda classe aceita os prefixos de breakpoint do Tailwind. Comece pensando em mobile com col-12 e depois mude a largura em telas maiores com sm:, md:, lg: e assim por diante. Use os botões de largura acima da pré-visualização para ver cada breakpoint entrar em ação.
Pré-visualização
768px · md · 0%
HTML editável
A pré-visualização é um viewport de verdade. Ela mostra a largura e o breakpoint no canto, e os botões de celular, tablet e desktop a alternam, então md: e lg: se aplicam exatamente como naquela tela.
Gutters
Gutters são os espaços entre as colunas. .g-* define as duas direções, .gx-* só a horizontal e .gy-* só a vertical. Os números vêm da escala de espaçamento do Tailwind, então g-4 é o mesmo degrau que p-4.
Pré-visualização
HTML editável
Coloque as classes de gutter na .row. Use g-0 para remover os espaços por completo.
Offsets
.offset-* empurra uma coluna essa quantidade de partes. É o jeito rápido de centralizar uma coluna ou deixar um espaço. Os offsets também funcionam com prefixos de breakpoint, como lg:offset-3.
Pré-visualização
HTML editável
Os offsets usam margin-inline-start, então empurram do lado certo quando a página é da direita para a esquerda. Experimente o botão RTL acima da pré-visualização.
Colunas por linha
Quando todas as colunas têm o mesmo tamanho, defina isso uma vez na linha em vez de em cada filho. .row-cols-1 a .row-cols-6 dão a cada filho uma parte igual, e .row-cols-auto os dimensiona pelo conteúdo.
Pré-visualização
HTML editável
Combine com breakpoints para mudar o número de colunas conforme a tela cresce, por exemplo row-cols-2 lg:row-cols-3.
Aninhamento
Uma coluna pode conter sua própria .row. A linha aninhada começa um novo grid de 12 partes dentro da coluna, então você pode dividir um espaço quantas vezes precisar.
Pré-visualização
HTML editável
Alinhamento e ordem
Uma .row é um contêiner flex normal, então as utilitárias de flexbox do Tailwind funcionam nela: items-*, justify-*, self-* e order-*. O plugin não as redefine.
Pré-visualização
HTML editável
Trocas no estilo order-2 md:order-1 são um padrão comum: empilhe em uma ordem no celular e inverta em telas maiores.
Da direita para a esquerda
Defina dir="rtl" no contêiner, ou em <html> para a página toda, e o grid flui a partir da direita. É a opção para árabe, persa, hebraico e outros idiomas RTL.
Pré-visualização
HTML editável
Nada a configurar. Os gutters da linha são simétricos e os offsets usam propriedades lógicas, então se invertem sozinhos.
Bom saber
Da direita para a esquerda
Adicione dir="rtl" e o grid se espelha sozinho. Não há nada a configurar.
Para a página toda
index.html
<html dir="rtl">
...
</html>
Para uma seção
index.html
<div class="container" dir="rtl">
<div class="row">
<div class="col-6 offset-3">Starts from the right</div>
</div>
</div>
Por que simplesmente funciona
Os offsets usam margin-inline-start, e as margens negativas da linha e o preenchimento das colunas são simétricos, então se invertem sozinhos. Use o botão RTL em qualquer exemplo acima para ver.
Bom saber
Perguntas frequentes
Respostas para as perguntas mais comuns.
Não. O container do Tailwind continua fornecendo as larguras máximas por breakpoint. O plugin acrescenta por cima a centralização e um preenchimento que considera o gutter. Se preferir não ter isso, defina generateContainers como false.
Sim, essa é a ideia. Uma .row é um contêiner flex, então items-center, justify-between, order-2, mt-4 e o resto se aplicam a ela e às suas colunas como de costume.
O Tailwind só gera CSS para as classes que encontra nos seus arquivos de origem. No seu próprio projeto isso é automático. Nesta página os exemplos editáveis podem conter qualquer coisa, então a demo gera antecipadamente todas as classes e breakpoints do plugin.
Não. O script do CDN não consegue carregar plugins do npm. Use uma configuração de build como Vite, PostCSS, Webpack ou a CLI do Tailwind.
Tailwind v3.4 e v4, com Node 18 ou mais recente. O pacote traz builds ESM e CommonJS com tipos do TypeScript.
Os nomes das classes são parecidos: col-md-6 vira md:col-6, e os números de gutter seguem a escala do Tailwind. O guia de migração tem a equivalência completa e um comando que converte seu código.