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.
.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.
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.
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.
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 CSS
Option
Notes
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
La valeur la plus spécifique l'emporte.
2
--bs-global-gutter-x
gutters
Valeur de repli commune aux deux.
3
1.5rem (x) et 0 (y)
valeur par défaut intégrée
Les 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 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
Classe
Ce qu'elle fait
Notes
.container
width: 100% ; centré ; remplissage selon le gutter
La largeur maximale vient des breakpoints de Tailwind.
.container-fluid
comme .container
Pleine largeur à chaque breakpoint.
.row
display: flex; flex-wrap: wrap; marges négatives
Annule le gutter extérieur et dispose ses enfants.
Colonnes
Classes de Colonnes
Classe
Ce qu'elle fait
Notes
.col
flex: 1 0 0%
Partage équitablement l'espace restant.
.col-auto
flex: 0 0 auto; width: auto
Dimensionnée selon son contenu.
.col-1 … .col-12
flex: 0 0 auto; width: n / 12
Occupe n parts sur 12.
Offsets et colonnes par ligne
Classes de Offsets et colonnes par ligne
Classe
Ce qu'elle fait
Notes
.offset-0 … .offset-12
margin-inline-start: n / 12
S'inverse automatiquement en RTL.
.row-cols-1 … .row-cols-6
les enfants reçoivent width: 1 / n
Se définit sur la .row et s'applique à chaque enfant.
.row-cols-auto
les enfants reçoivent width: auto
Les enfants sont dimensionnés selon leur contenu.
Gutters
Classes de Gutters
Classe
Ce qu'elle fait
Notes
.g-*
--bs-gutter-x et --bs-gutter-y
Les deux directions.
.gx-*
--bs-gutter-x
Horizontal uniquement.
.gy-*
--bs-gutter-y
Vertical 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.
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.