Plugin de Tailwind CSS · v1.4.2

El grid de Bootstrap, para Tailwind.

Si ya piensas en filas y columnas, sigue haciéndolo. tw-bootstrap-grid añade a Tailwind el conocido grid de 12 columnas, con .row, .col-6, .offset-2 y .g-4, con soporte para RTL y sin imponer cómo deben verse tus componentes.

$npm install tw-bootstrap-grid

Qué obtienes

  • Grid de 12 columnas

    .row, .col, .col-auto y de .col-1 a .col-12, igual que en Bootstrap.

  • Gutters de tu tema

    .g-*, .gx-* y .gy-* usan la escala de espaciado de Tailwind, así que encajan con el resto de tu diseño.

  • Offsets

    De .offset-0 a .offset-12 para centrar una columna o dejar un hueco.

  • Columnas por fila

    De .row-cols-1 a .row-cols-6 y .row-cols-auto dimensionan a todos los hijos con una sola clase en la fila.

  • Contenedores

    .container y .container-fluid con un relleno que tiene en cuenta el gutter. Los anchos máximos vienen de los breakpoints de Tailwind.

  • Responsive y RTL

    Todas las clases admiten los prefijos de breakpoint de Tailwind, como md:col-6, y se invierten correctamente con dir="rtl".

Solo se ocupa del layout: sin colores, sin componentes, sin resets. Añade a Tailwind en lugar de sustituir nada, así que puedes mezclar col-4 y flex en la misma página sin pensarlo dos veces.

Primeros pasos

Instalación

Tres pasos: instala el paquete, registra el plugin y empieza a usar las clases.

1Instala el paquete

npm install tw-bootstrap-grid

2Registra el plugin

Elige tu versión de Tailwind en la cabecera y el fragmento de abajo se adapta. Tailwind v4 registra los plugins en el CSS, v3 en el archivo de configuración.

Tailwind v4

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

En una configuración v3 con CommonJS, plugins: [require("tw-bootstrap-grid")] también funciona.

3Usa las clases

Eso es todo. Úsalas en tu HTML como cualquier otra clase de Tailwind. Todo lo que puedes hacer con sm:, md: o hover: también funciona aquí.

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>

Necesitas un paso de compilación

El plugin se ejecuta dentro del compilador de Tailwind (PostCSS, Vite, Webpack, la CLI de Tailwind…). No funciona con el script Play CDN de Tailwind, que no puede cargar plugins desde npm.

Primeros pasos

Configuración

Los valores por defecto coinciden con Bootstrap, así que puedes saltarte esta página. Vuelve cuando quieras otros breakpoints o tamaños de gutter.

Breakpoints

El plugin no tiene breakpoints propios. Los prefijos como md:col-6 y el ancho máximo de .container vienen de Tailwind, así que al cambiar tus pantallas cambia también el grid.

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 */
}

Tamaños de gutter

Los gutters son el espacio entre columnas. Por defecto son 1.5rem en horizontal y 0 en vertical. Puedes definirlo una vez para todo, o por separado para contenedores y filas. En v3 pasas opciones al plugin, en v4 defines variables 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;
}
Orden de resolución del gutter
PrioridadVariable CSSOpciónNotas
1--bs-row-gutter-x / --bs-container-gutter-xrowGutters / containerGuttersGana el valor más específico.
2--bs-global-gutter-xguttersValor de respaldo compartido por ambos.
31.5rem (x) y 0 (y)valor por defecto integradoLos mismos valores por defecto que usa Bootstrap.

Las variables CSS se leen en tiempo de ejecución, así que en cualquiera de las dos versiones también puedes redefinirlas en cualquier elemento para cambiar los gutters solo de esa sección. Para una sola fila, usa .g-*, .gx-* y .gy-*.

Desactiva los contenedores

¿Prefieres usar solo el container de Tailwind? Pon generateContainers en false y el plugin deja de generar .container-fluid y su relleno que tiene en cuenta el gutter. Las filas y las columnas no se ven afectadas.

Tailwind v4

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

¿Por qué variables en v4?

Tailwind v4 puede pasar a un plugin valores simples como generateContainers: false;, pero no objetos anidados como gutters. Las variables CSS cubren ese caso y además se pueden redefinir por elemento.

Referencia

Clases

Todo lo que añade el plugin, en un solo lugar.

Layout

Clases de Layout
ClaseQué haceNotas
.containerwidth: 100%; centrado; relleno según el gutterEl ancho máximo viene de los breakpoints de Tailwind.
.container-fluidigual que .containerAncho completo en todos los breakpoints.
.rowdisplay: flex; flex-wrap: wrap; márgenes negativosAnula el gutter exterior y coloca a sus hijos.

Columnas

Clases de Columnas
ClaseQué haceNotas
.colflex: 1 0 0%Reparte el espacio restante a partes iguales.
.col-autoflex: 0 0 auto; width: autoSe dimensiona según su contenido.
.col-1 … .col-12flex: 0 0 auto; width: n / 12Ocupa n de 12 partes.

Offsets y columnas por fila

Clases de Offsets y columnas por fila
ClaseQué haceNotas
.offset-0 … .offset-12margin-inline-start: n / 12Se invierte solo en RTL.
.row-cols-1 … .row-cols-6los hijos reciben width: 1 / nSe define en la .row y se aplica a todos los hijos.
.row-cols-autolos hijos reciben width: autoLos hijos se dimensionan según su contenido.

Gutters

Clases de Gutters
ClaseQué haceNotas
.g-*--bs-gutter-x y --bs-gutter-yAmbas direcciones.
.gx-*--bs-gutter-xSolo horizontal.
.gy-*--bs-gutter-ySolo vertical.

Todo es responsive

Añade un prefijo de breakpoint a cualquiera de las clases anteriores: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.

¿Qué pasos de gutter existen?

.g-*, .gx-* y .gy-* se generan a partir de tu tema de espaciado. En v3 es cada clave de theme.spacing sin punto (así que g-4 sí, g-0.5 no). En v4 es la escala por defecto, de g-0 a g-96 y g-px.

La alineación y el orden vienen de Tailwind

El plugin no incluye sus propios justify-*, items-* ni order-*. Una .row es un contenedor flex normal, así que las utilidades de Tailwind funcionan directamente sobre ella.

Si vienes de Bootstrap

Migrar desde Bootstrap

El grid funciona como lo recuerdas. Tres cosas se ven distintas: cómo se escriben las clases responsive, los números de espaciado y los anchos de los breakpoints.

  • Lo que no cambia

    La estructura: .container, .row, .col-*, .offset-*, .row-cols-*. Incluso las variables CSS mantienen su nombre, --bs-gutter-x y --bs-gutter-y, así que el CSS propio que las lee sigue funcionando.

  • Prefijo, no infijo

    Bootstrap escribe col-md-6. Tailwind escribe md:col-6. Es el cambio que más vas a tocar, y un script puede hacerlo por ti.

  • Números distintos

    Los números de gutter y de espaciado siguen la escala de Tailwind, así que el g-3 de Bootstrap es g-4 aquí. Los anchos de los breakpoints también difieren un poco.

La guía completa incluye las tablas de equivalencias, los cambios de tamaño de gutter, cómo igualar los breakpoints de Bootstrap y un comando que convierte tu código.

Leer la guía de migración

Uso

Ejemplos

Todos los ejemplos son interactivos. Edita el HTML de la izquierda y la vista previa se actualiza mientras escribes. Si conoces el grid de Bootstrap (se abre en una pestaña nueva), te resultará familiar.

Un layout básico

Un .container centra tu contenido, una .row coloca las columnas una junto a otra y cada .col-* ocupa esa cantidad de las 12 partes disponibles. Dos columnas col-6 dividen la fila por la mitad.

Vista previa
HTML editable

Las columnas siempre saltan de línea. Lo que pase de 12 partes en una fila baja a la línea siguiente, algo muy útil para listas de tarjetas.

Columnas iguales y de ancho automático

Un .col sin más reparte el espacio que quede, así que tres de ellas son tres columnas iguales. .col-auto se dimensiona según su contenido y el .col vecino ocupa el resto.

Vista previa
HTML editable

Columnas responsive

Todas las clases admiten los prefijos de breakpoint de Tailwind. Empieza pensando en móvil con col-12 y cambia el ancho en pantallas mayores con sm:, md:, lg: y los demás. Usa los botones de ancho sobre la vista previa para ver cada breakpoint en acción.

Vista previa
768px · md · 0%
HTML editable

La vista previa es un viewport real. Muestra el ancho y el breakpoint en la esquina, y los botones de móvil, tableta y escritorio lo cambian, así que md: y lg: se aplican igual que en esa pantalla.

Gutters

Los gutters son los huecos entre columnas. .g-* define ambas direcciones, .gx-* solo la horizontal y .gy-* solo la vertical. Los números vienen de la escala de espaciado de Tailwind, así que g-4 es el mismo paso que p-4.

Vista previa
HTML editable

Pon las clases de gutter en la .row. Usa g-0 para quitar los huecos por completo.

Offsets

.offset-* desplaza una columna esa cantidad de partes. Es la forma rápida de centrar una columna o dejar un hueco. Los offsets también admiten prefijos de breakpoint, como lg:offset-3.

Vista previa
HTML editable

Los offsets usan margin-inline-start, así que empujan desde el lado correcto cuando la página va de derecha a izquierda. Prueba el botón RTL sobre la vista previa.

Columnas por fila

Cuando todas las columnas tienen el mismo tamaño, defínelo una vez en la fila en lugar de en cada hijo. .row-cols-1 a .row-cols-6 dan a cada hijo una parte igual, y .row-cols-auto los dimensiona según su contenido.

Vista previa
HTML editable

Combínalo con breakpoints para cambiar el número de columnas a medida que crece la pantalla, por ejemplo row-cols-2 lg:row-cols-3.

Anidamiento

Una columna puede contener su propia .row. La fila anidada empieza un grid nuevo de 12 partes dentro de la columna, así que puedes dividir un espacio tantas veces como necesites.

Vista previa
HTML editable

Alineación y orden

Una .row es un contenedor flex normal, así que las utilidades de flexbox de Tailwind funcionan sobre ella: items-*, justify-*, self-* y order-*. El plugin no las redefine.

Vista previa
HTML editable

Los cambios del estilo order-2 md:order-1 son un patrón habitual: apila en un orden en móvil y inviértelo en pantallas mayores.

De derecha a izquierda

Pon dir="rtl" en el contenedor, o en <html> para toda la página, y el grid fluye desde la derecha. Es la opción para árabe, persa, hebreo y otros idiomas RTL.

Vista previa
HTML editable

No hay nada que configurar. Los gutters de la fila son simétricos y los offsets usan propiedades lógicas, así que se invierten solos.

Conviene saber

De derecha a izquierda

Añade dir="rtl" y el grid se refleja solo. No hay nada que configurar.

Para toda la página

index.html
<html dir="rtl">
  ...
</html>

Para una sola sección

index.html
<div class="container" dir="rtl">
  <div class="row">
    <div class="col-6 offset-3">Starts from the right</div>
  </div>
</div>

Por qué funciona sin más

Los offsets usan margin-inline-start, y los márgenes negativos de la fila y el relleno de las columnas son simétricos, así que se invierten solos. Usa el botón RTL en cualquier ejemplo de arriba para verlo.

Conviene saber

Preguntas frecuentes

Respuestas a las preguntas que más se repiten.

No. El container de Tailwind sigue aportando los anchos máximos por breakpoint. El plugin añade encima el centrado y un relleno que tiene en cuenta el gutter. Si prefieres no tenerlo, pon generateContainers en false.

Sí, esa es la idea. Una .row es un contenedor flex, así que items-center, justify-between, order-2, mt-4 y el resto se aplican a ella y a sus columnas como siempre.

Tailwind solo genera CSS para las clases que encuentra en tus archivos fuente. En tu propio proyecto eso es automático. En esta página los ejemplos editables pueden contener cualquier cosa, así que la demo genera de antemano todas las clases y breakpoints del plugin.

No. El script del CDN no puede cargar plugins desde npm. Usa una configuración de compilación como Vite, PostCSS, Webpack o la CLI de Tailwind.

Tailwind v3.4 y v4, con Node 18 o superior. El paquete incluye compilaciones ESM y CommonJS con tipos de TypeScript.

Los nombres de las clases son parecidos: col-md-6 pasa a ser md:col-6 y los números de gutter siguen la escala de Tailwind. La guía de migración tiene la equivalencia completa y un comando que convierte tu código.

¿Has encontrado un error o tienes una idea?

Abre un issue (se abre en una pestaña nueva) o envía un pull request (se abre en una pestaña nueva) en GitHub. Las correcciones pequeñas y las mejoras de la documentación son muy bienvenidas.