Plugin do Tailwind CSS · v1.4.2

O grid do Bootstrap, para o Tailwind.

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.

$npm install tw-bootstrap-grid

O que você recebe

  • Grid de 12 colunas

    .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.

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";

Em uma configuração v3 com CommonJS, plugins: [require("tw-bootstrap-grid")] também funciona.

3Use as classes

Pronto. Use-as no seu HTML como qualquer outra classe do Tailwind. Tudo o que você faz com sm:, md: ou hover: funciona aqui também.

index.html
<div class="container">
  <div class="row g-4">
    <div class="col-12 md:col-6 lg:col-4">One</div>
    <div class="col-12 md:col-6 lg:col-4">Two</div>
    <div class="col-12 lg:col-4">Three</div>
  </div>
</div>

Você precisa de uma etapa de build

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.

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";

@theme {
  --breakpoint-sm: 40rem;  /* 640px */
  --breakpoint-md: 48rem;  /* 768px */
  --breakpoint-lg: 64rem;  /* 1024px */
  --breakpoint-xl: 80rem;  /* 1280px */
  --breakpoint-2xl: 96rem; /* 1536px */
}

Tamanhos de gutter

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
PrioridadeVariável CSSOpçãoObservações
1--bs-row-gutter-x / --bs-container-gutter-xrowGutters / containerGuttersO valor mais específico vence.
2--bs-global-gutter-xguttersValor de reserva compartilhado pelos dois.
31.5rem (x) e 0 (y)padrão embutidoOs 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.

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid" {
  generateContainers: false;
}

Por que variáveis no v4?

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
ClasseO que fazObservações
.containerwidth: 100%; centralizado; preenchimento conforme o gutterA largura máxima vem dos breakpoints do Tailwind.
.container-fluidigual a .containerLargura total em todos os breakpoints.
.rowdisplay: flex; flex-wrap: wrap; margens negativasAnula o gutter externo e organiza seus filhos.

Colunas

Classes de Colunas
ClasseO que fazObservações
.colflex: 1 0 0%Divide o espaço restante igualmente.
.col-autoflex: 0 0 auto; width: autoDimensionada pelo conteúdo.
.col-1 … .col-12flex: 0 0 auto; width: n / 12Ocupa n de 12 partes.

Offsets e colunas por linha

Classes de Offsets e colunas por linha
ClasseO que fazObservações
.offset-0 … .offset-12margin-inline-start: n / 12Se inverte automaticamente em RTL.
.row-cols-1 … .row-cols-6os filhos recebem width: 1 / nDefinida na .row, vale para todos os filhos.
.row-cols-autoos filhos recebem width: autoOs filhos são dimensionados pelo conteúdo.

Gutters

Classes de Gutters
ClasseO que fazObservações
.g-*--bs-gutter-x e --bs-gutter-yAs duas direções.
.gx-*--bs-gutter-xSomente horizontal.
.gy-*--bs-gutter-ySomente 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.

Ler o guia de migração

Uso

Exemplos

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.

Encontrou um bug ou tem uma ideia?

Abra uma issue (abre em uma nova aba) ou envie um pull request (abre em uma nova aba) no GitHub. Correções pequenas e melhorias na documentação são muito bem-vindas.