Guide
Migrer une grille Bootstrap vers Tailwind CSS
Passer une mise en page de la grille Bootstrap à Tailwind demande cinq étapes et, pour l'essentiel, une seule commande. Ce guide explique ce qui change, comment les classes se correspondent et les quelques points qu'un script ne peut pas faire à votre place.
La migration en cinq étapes
Installer le plugin
Installez tw-bootstrap-grid et enregistrez-le dans votre configuration Tailwind. Le guide d'installation contient les extraits pour Tailwind v3 et v4.
Reprendre les breakpoints de Bootstrap (facultatif)
Si vous voulez que les mises en page changent aux mêmes largeurs qu'avant, réglez les écrans de Tailwind sur 576, 768, 992, 1200 et 1400px. Voir les breakpoints plus bas.
Renommer les classes
Faites un commit de votre travail, puis lancez la commande Perl ci-dessous. Elle renumérote les gutters et transforme le
col-md-6de Bootstrap enmd:col-6.Corriger ce que la commande ne peut pas faire
Changez les utilitaires d'espacement comme
mb-3enmb-4, remplacez les utilitaires display et flex de Bootstrap par ceux de Tailwind et remplacez les classes commecontainer-md.Retirer le CSS de Bootstrap et vérifier le résultat
Retirez la feuille de style de Bootstrap, puis parcourez vos pages en largeur téléphone, tablette et ordinateur.
Ce qui change et ce qui ne change pas
Ce qui ne change pas
La structure :
.container,.row,.col-*,.offset-*,.row-cols-*. Même les variables CSS gardent leur nom,--bs-gutter-xet--bs-gutter-y, et le CSS maison qui les lit continue donc de fonctionner.Préfixe, pas infixe
Bootstrap écrit
col-md-6. Tailwind écritmd: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-3de Bootstrap devient doncg-4. Les largeurs de breakpoints diffèrent un peu aussi.
La même mise en page, avant et après
Bootstrap 5
<div class="container">
<div class="row g-3">
<div class="col-12 col-md-6 col-lg-4">A</div>
<div class="col-12 col-md-6 col-lg-4">B</div>
<div class="col-12 col-md-12 col-lg-4">C</div>
</div>
</div>tw-bootstrap-grid
<div class="container">
<div class="row g-4">
<div class="col-12 md:col-6 lg:col-4">A</div>
<div class="col-12 md:col-6 lg:col-4">B</div>
<div class="col-12 md:col-12 lg:col-4">C</div>
</div>
</div>Correspondance des classes
Classes responsive
| Bootstrap | Ici | Notes |
|---|---|---|
col-md-6 | md:col-6 | Tailwind place le breakpoint devant, comme préfixe. |
col-lg | lg:col | Idem pour la colonne à largeur égale. |
col-xl-auto | xl:col-auto | |
offset-md-3 | md:offset-3 | |
row-cols-md-3 | md:row-cols-3 | |
g-md-4 | md:g-6 | Le nombre change aussi, voir les tailles de gutter plus bas. |
col-xxl-4 | 2xl:col-4 | Le xxl de Bootstrap s'appelle 2xl dans Tailwind. |
order-md-2 | md:order-2 | order-* vient de Tailwind et va jusqu'à 12. |
Tailles de gutter
| Bootstrap | Ici | Taille |
|---|---|---|
g-0 | g-0 | 0 |
g-1 | g-1 | 0.25rem |
g-2 | g-2 | 0.5rem |
g-3 | g-4 | 1rem |
g-4 | g-6 | 1.5rem |
g-5 | g-12 | 3rem |
Utilitaires fournis par Tailwind
| Bootstrap | Ici | Notes |
|---|---|---|
d-flex | flex | |
d-none d-md-block | hidden md:block | |
justify-content-between | justify-between | |
align-items-center | items-center | |
align-self-end | self-end | |
mb-3, p-3 | mb-4, p-4 | Les utilitaires d'espacement se décalent de la même façon que les gutters. |
Reprendre les breakpoints de Bootstrap
Les breakpoints de Bootstrap sont 576, 768, 992, 1200 et 1400px. Ceux de Tailwind sont 640, 768, 1024, 1280 et 1536px : une mise en page peut donc changer un peu plus tôt ou plus tard après la migration. Si cela compte, réglez les écrans de Tailwind sur les valeurs de Bootstrap.
Tailwind v4
@import "tailwindcss";
@plugin "tw-bootstrap-grid";
@theme {
--breakpoint-sm: 36rem; /* 576px */
--breakpoint-md: 48rem; /* 768px */
--breakpoint-lg: 62rem; /* 992px */
--breakpoint-xl: 75rem; /* 1200px */
--breakpoint-2xl: 87.5rem; /* 1400px */
}Le container de Tailwind a la largeur du breakpoint sur lequel il se trouve : ses largeurs maximales deviennent donc 576, 768, 992, 1200 et 1400px. C'est proche des 540, 720, 960, 1140 et 1320px de Bootstrap, mais pas identique.
Renommer en masse
Cette commande Perl renumérote les gutters et transforme col-md-6 en md:col-6, col-xxl-4 en 2xl:col-4 et l'ancien no-gutters en g-0. Elle réécrit les fichiers sur place : faites donc un commit d'abord, puis lisez le diff ensuite.
perl -pi -e '
s/\b(g|gx|gy)-((?:sm|md|lg|xl|xxl)-)?([345])\b/"$1-".($2\/\/"").{3=>4,4=>6,5=>12}->{$3}/ge;
s/\bno-gutters\b/g-0/g;
s/\b(col|offset|order|row-cols|g|gx|gy)-(sm|md|lg|xl|xxl)(-([0-9]+|auto|first|last))?\b/$2:$1$3/g;
s/\bxxl:/2xl:/g;
' $(git ls-files '*.html' '*.jsx' '*.tsx' '*.vue' '*.svelte')Lancez-la une seule fois et vérifiez le résultat
mb-3 ou p-3 demandent donc une passe manuelle, et le motif correspond à tout texte qui ressemble à une classe, y compris dans les commentaires.Ce qui n'est pas repris
.container et .container-fluid : .container-sm, .container-md et les autres conteneurs responsive de Bootstrap ne sont donc pas inclus. Construisez-les avec les utilitaires max-w-* de Tailwind si vous en avez besoin. Les autres utilitaires de Bootstrap (display, flex, espacement, texte) sont remplacés par ceux de Tailwind, comme dans le dernier tableau ci-dessus.