Plugin Tailwind CSS · v1.4.2

La grille Bootstrap, pour Tailwind.

Si vous pensez déjà en lignes et en colonnes, continuez. tw-bootstrap-grid apporte à Tailwind la grille à 12 colonnes que vous connaissez, avec .row, .col-6, .offset-2 et .g-4, avec prise en charge du RTL et sans rien imposer sur l'apparence de vos composants.

$npm install tw-bootstrap-grid

Ce que vous obtenez

  • Grille à 12 colonnes

    .row, .col, .col-auto et de .col-1 à .col-12, exactement comme dans Bootstrap.

  • Gutters issus de votre thème

    .g-*, .gx-* et .gy-* utilisent l'échelle d'espacement de Tailwind et s'accordent donc avec le reste de votre design.

  • Offsets

    De .offset-0 à .offset-12 pour centrer une colonne ou laisser un vide.

  • Colonnes par ligne

    De .row-cols-1 à .row-cols-6 et .row-cols-auto dimensionnent tous les enfants avec une seule classe sur la ligne.

  • Conteneurs

    .container et .container-fluid avec un remplissage qui tient compte du gutter. Les largeurs maximales viennent des breakpoints de Tailwind.

  • Responsive et RTL

    Chaque classe accepte les préfixes de breakpoint de Tailwind, comme md:col-6, et s'inverse correctement avec dir="rtl".

Il ne s'occupe que de la mise en page : pas de couleurs, pas de composants, pas de resets. Il complète Tailwind sans rien remplacer, vous pouvez donc mélanger col-4 et flex sur la même page sans y réfléchir à deux fois.

Pour commencer

Installation

Trois étapes : installer le paquet, enregistrer le plugin, utiliser les classes.

1Installer le paquet

npm install tw-bootstrap-grid

2Enregistrer le plugin

Choisissez votre version de Tailwind dans l'en-tête et l'extrait ci-dessous s'adapte. Tailwind v4 enregistre les plugins dans le CSS, v3 dans le fichier de configuration.

Tailwind v4

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

Dans une configuration v3 en CommonJS, plugins: [require("tw-bootstrap-grid")] fonctionne aussi.

3Utiliser les classes

C'est tout. Utilisez-les dans votre balisage comme n'importe quelle autre classe Tailwind. Tout ce que vous faites avec sm:, md: ou hover: fonctionne ici aussi.

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>

Une étape de compilation est nécessaire

Le plugin s'exécute dans le compilateur de Tailwind (PostCSS, Vite, Webpack, la CLI de Tailwind…). Il ne fonctionne pas avec le script Tailwind Play CDN, qui ne peut pas charger de plugins depuis npm.

Pour commencer

Configuration

Les valeurs par défaut correspondent à Bootstrap, vous pouvez donc passer cette page. Revenez-y quand vous voulez d'autres breakpoints ou d'autres tailles de gutter.

Breakpoints

Le plugin n'a pas de breakpoints à lui. Les préfixes comme md:col-6 et la largeur maximale de .container viennent tous deux de Tailwind : modifier vos écrans modifie donc aussi la grille.

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

Tailles de gutter

Les gutters sont l'espace entre les colonnes. Par défaut, c'est 1.5rem à l'horizontale et 0 à la verticale. Vous pouvez le définir une fois pour tout, ou séparément pour les conteneurs et les lignes. En v3, vous passez des options au plugin ; en v4, vous définissez des 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;
}
Ordre de résolution du gutter
PrioritéVariable CSSOptionNotes
1--bs-row-gutter-x / --bs-container-gutter-xrowGutters / containerGuttersLa valeur la plus spécifique l'emporte.
2--bs-global-gutter-xguttersValeur de repli commune aux deux.
31.5rem (x) et 0 (y)valeur par défaut intégréeLes mêmes valeurs par défaut que Bootstrap.

Les variables CSS sont lues à l'exécution : dans les deux versions, vous pouvez donc aussi les redéfinir sur n'importe quel élément pour modifier les gutters de cette seule section. Pour une seule ligne, utilisez .g-*, .gx-* et .gy-*.

Désactiver les conteneurs

Vous préférez n'utiliser que le container de Tailwind ? Mettez generateContainers à false et le plugin cesse de générer .container-fluid et son remplissage qui tient compte du gutter. Les lignes et les colonnes ne sont pas touchées.

Tailwind v4

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

Pourquoi des variables en v4 ?

Tailwind v4 peut transmettre à un plugin des valeurs simples comme generateContainers: false;, mais pas des objets imbriqués comme gutters. Les variables CSS couvrent ce cas et peuvent en plus être redéfinies élément par élément.

Référence

Classes

Tout ce que le plugin ajoute, au même endroit.

Mise en page

Classes de Mise en page
ClasseCe qu'elle faitNotes
.containerwidth: 100% ; centré ; remplissage selon le gutterLa largeur maximale vient des breakpoints de Tailwind.
.container-fluidcomme .containerPleine largeur à chaque breakpoint.
.rowdisplay: flex; flex-wrap: wrap; marges négativesAnnule le gutter extérieur et dispose ses enfants.

Colonnes

Classes de Colonnes
ClasseCe qu'elle faitNotes
.colflex: 1 0 0%Partage équitablement l'espace restant.
.col-autoflex: 0 0 auto; width: autoDimensionnée selon son contenu.
.col-1 … .col-12flex: 0 0 auto; width: n / 12Occupe n parts sur 12.

Offsets et colonnes par ligne

Classes de Offsets et colonnes par ligne
ClasseCe qu'elle faitNotes
.offset-0 … .offset-12margin-inline-start: n / 12S'inverse automatiquement en RTL.
.row-cols-1 … .row-cols-6les enfants reçoivent width: 1 / nSe définit sur la .row et s'applique à chaque enfant.
.row-cols-autoles enfants reçoivent width: autoLes enfants sont dimensionnés selon leur contenu.

Gutters

Classes de Gutters
ClasseCe qu'elle faitNotes
.g-*--bs-gutter-x et --bs-gutter-yLes deux directions.
.gx-*--bs-gutter-xHorizontal uniquement.
.gy-*--bs-gutter-yVertical uniquement.

Tout est responsive

Ajoutez un préfixe de breakpoint à n'importe quelle classe ci-dessus : md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.

Quelles valeurs de gutter existent ?

.g-*, .gx-* et .gy-* sont générées à partir de votre thème d'espacement. En v3, ce sont toutes les clés de theme.spacing sans point (donc g-4 oui, g-0.5 non). En v4, c'est l'échelle par défaut, de g-0 à g-96 et g-px.

L'alignement et l'ordre viennent de Tailwind

Le plugin ne fournit pas ses propres justify-*, items-* ni order-*. Une .row est un conteneur flex ordinaire : les utilitaires de Tailwind fonctionnent donc directement dessus.

Vous venez de Bootstrap

Migrer depuis Bootstrap

La grille fonctionne comme vous vous en souvenez. Trois choses diffèrent : l'écriture des classes responsive, les nombres d'espacement et les largeurs des breakpoints.

  • Ce qui ne change pas

    La structure : .container, .row, .col-*, .offset-*, .row-cols-*. Même les variables CSS gardent leur nom, --bs-gutter-x et --bs-gutter-y, et le CSS maison qui les lit continue donc de fonctionner.

  • Préfixe, pas infixe

    Bootstrap écrit col-md-6. Tailwind écrit md:col-6. C'est le changement que vous toucherez le plus, et un script peut le faire à votre place.

  • Des nombres différents

    Les nombres de gutter et d'espacement suivent l'échelle de Tailwind : le g-3 de Bootstrap devient donc g-4. Les largeurs de breakpoints diffèrent un peu aussi.

Le guide complet contient les tableaux de correspondance, les changements de taille de gutter, la façon de reprendre les breakpoints de Bootstrap et une commande qui convertit votre code.

Lire le guide de migration

Utilisation

Exemples

Chaque exemple est interactif. Modifiez le HTML à gauche, l'aperçu se met à jour pendant que vous tapez. Si vous connaissez la grille Bootstrap (s'ouvre dans un nouvel onglet), cela vous sera familier.

Une mise en page de base

Un .container centre votre contenu, une .row aligne les colonnes côte à côte et chaque .col-* occupe ce nombre de parts sur les 12 disponibles. Deux colonnes col-6 partagent la ligne en deux.

Aperçu
HTML modifiable

Les colonnes passent toujours à la ligne. Tout ce qui dépasse 12 parts sur une même ligne descend à la suivante, ce qui est pratique pour des listes de cartes.

Colonnes égales et à largeur automatique

Un .col seul se partage l'espace restant : trois d'entre elles font donc trois colonnes égales. .col-auto se dimensionne selon son contenu et le .col voisin prend le reste.

Aperçu
HTML modifiable

Colonnes responsive

Chaque classe accepte les préfixes de breakpoint de Tailwind. Commencez en pensant mobile avec col-12, puis changez la largeur sur les écrans plus grands avec sm:, md:, lg: et les suivants. Utilisez les boutons de largeur au-dessus de l'aperçu pour voir chaque breakpoint entrer en jeu.

Aperçu
768px · md · 0%
HTML modifiable

L'aperçu est un vrai viewport. Il affiche la largeur et le breakpoint dans le coin, et les boutons téléphone, tablette et ordinateur le changent : md: et lg: s'appliquent donc exactement comme sur cet écran.

Gutters

Les gutters sont les espaces entre les colonnes. .g-* règle les deux directions, .gx-* seulement l'horizontale et .gy-* seulement la verticale. Les nombres viennent de l'échelle d'espacement de Tailwind : g-4 correspond au même palier que p-4.

Aperçu
HTML modifiable

Placez les classes de gutter sur la .row. Utilisez g-0 pour supprimer complètement les espaces.

Offsets

.offset-* décale une colonne de ce nombre de parts. C'est le moyen rapide de centrer une colonne ou de laisser un vide. Les offsets acceptent aussi les préfixes de breakpoint, comme lg:offset-3.

Aperçu
HTML modifiable

Les offsets utilisent margin-inline-start : ils poussent donc du bon côté quand la page est de droite à gauche. Essayez le bouton RTL au-dessus de l'aperçu.

Colonnes par ligne

Quand toutes les colonnes ont la même taille, définissez-le une fois sur la ligne plutôt que sur chaque enfant. .row-cols-1 à .row-cols-6 donnent à chaque enfant une part égale, et .row-cols-auto les dimensionne selon leur contenu.

Aperçu
HTML modifiable

Combinez-le avec des breakpoints pour changer le nombre de colonnes à mesure que l'écran grandit, par exemple row-cols-2 lg:row-cols-3.

Imbrication

Une colonne peut contenir sa propre .row. La ligne imbriquée démarre une nouvelle grille de 12 parts à l'intérieur de la colonne : vous pouvez donc diviser un espace autant de fois que nécessaire.

Aperçu
HTML modifiable

Alignement et ordre

Une .row est un conteneur flex normal : les utilitaires flexbox de Tailwind fonctionnent donc dessus : items-*, justify-*, self-* et order-*. Le plugin ne les redéfinit pas.

Aperçu
HTML modifiable

Les permutations du type order-2 md:order-1 sont un schéma courant : empiler dans un ordre sur téléphone, l'inverser sur les écrans plus grands.

De droite à gauche

Mettez dir="rtl" sur le conteneur, ou sur <html> pour toute la page, et la grille s'écoule depuis la droite. C'est ce qu'il faut pour l'arabe, le persan, l'hébreu et les autres langues RTL.

Aperçu
HTML modifiable

Rien à configurer. Les gutters de la ligne sont symétriques et les offsets utilisent des propriétés logiques : ils s'inversent donc tout seuls.

Bon à savoir

De droite à gauche

Ajoutez dir="rtl" et la grille se reflète. Il n'y a rien à configurer.

Pour toute la page

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

Pour une seule section

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

Pourquoi ça marche tout seul

Les offsets utilisent margin-inline-start, et les marges négatives de la ligne ainsi que le remplissage des colonnes sont symétriques : ils s'inversent donc tout seuls. Utilisez le bouton RTL sur n'importe quel exemple ci-dessus pour le voir.

Bon à savoir

Questions fréquentes

Les réponses aux questions qui reviennent le plus souvent.

Non. Le container de Tailwind continue de fournir les largeurs maximales par breakpoint. Le plugin ajoute par-dessus le centrage et un remplissage qui tient compte du gutter. Si vous ne le souhaitez pas, mettez generateContainers à false.

Oui, c'est l'idée. Une .row est un conteneur flex : items-center, justify-between, order-2, mt-4 et les autres s'appliquent donc à elle et à ses colonnes comme d'habitude.

Tailwind ne génère du CSS que pour les classes qu'il trouve dans vos fichiers source. Dans votre propre projet, c'est automatique. Sur cette page, les exemples modifiables peuvent contenir n'importe quoi : la démo génère donc à l'avance chaque classe et chaque breakpoint du plugin.

Non. Le script du CDN ne peut pas charger de plugins depuis npm. Utilisez une chaîne de compilation comme Vite, PostCSS, Webpack ou la CLI de Tailwind.

Tailwind v3.4 et v4, avec Node 18 ou plus récent. Le paquet fournit des builds ESM et CommonJS avec les types TypeScript.

Les noms de classes sont proches : col-md-6 devient md:col-6, et les nombres de gutter suivent l'échelle de Tailwind. Le guide de migration contient la correspondance complète et une commande qui convertit votre code.

Vous avez trouvé un bug ou vous avez une idée ?

Ouvrez une issue (s'ouvre dans un nouvel onglet) ou envoyez une pull request (s'ouvre dans un nouvel onglet) sur GitHub. Les petites corrections et les améliorations de la documentation sont les bienvenues.