Anleitung
Ein Bootstrap-Grid zu Tailwind CSS migrieren
Ein Layout vom Grid von Bootstrap zu Tailwind umzuziehen dauert fünf Schritte und größtenteils nur einen Befehl. Diese Anleitung zeigt, was sich ändert, wie die Klassen zugeordnet werden und die wenigen Dinge, die ein Skript nicht für dich erledigen kann.
Migration in fünf Schritten
Plugin installieren
Installiere tw-bootstrap-grid und registriere es in deinem Tailwind-Setup. Die Installationsanleitung enthält die Snippets für Tailwind v3 und v4.
Breakpoints von Bootstrap nachbilden (optional)
Wenn Layouts bei denselben Breiten wie zuvor umschalten sollen, setze die Screens von Tailwind auf 576, 768, 992, 1200 und 1400px. Siehe die Breakpoints weiter unten.
Klassen umbenennen
Committe deine Arbeit und führe dann den Perl-Befehl unten aus. Er nummeriert die Gutter neu und macht aus
col-md-6von Bootstrapmd:col-6.Beheben, was der Befehl nicht kann
Ändere Abstands-Utilities wie
mb-3inmb-4, tausche die Display- und Flex-Utilities von Bootstrap gegen die von Tailwind und ersetze Klassen wiecontainer-md.Bootstrap-CSS entfernen und Ergebnis prüfen
Nimm das Bootstrap-Stylesheet heraus und sieh dir deine Seiten dann bei Smartphone-, Tablet- und Desktop-Breite an.
Was sich ändert und was nicht
Was gleich bleibt
Die Struktur:
.container,.row,.col-*,.offset-*,.row-cols-*. Sogar die CSS-Variablen behalten ihre Namen,--bs-gutter-xund--bs-gutter-y, eigenes CSS, das sie liest, funktioniert also weiter.Präfix statt Infix
Bootstrap schreibt
col-md-6. Tailwind schreibtmd:col-6. Das ist die Änderung, die du am häufigsten anfassen wirst, und ein Skript kann sie für dich erledigen.Andere Zahlen
Gutter- und Abstandszahlen folgen der Skala von Tailwind, das
g-3von Bootstrap ist hier alsog-4. Auch die Breakpoint-Breiten weichen etwas ab.
Dasselbe Layout, vorher und nachher
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>Klassenzuordnung
Responsive Klassen
| Bootstrap | Hier | Hinweise |
|---|---|---|
col-md-6 | md:col-6 | Tailwind setzt den Breakpoint voran, als Präfix. |
col-lg | lg:col | Dasselbe gilt für die gleich breite Spalte. |
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 | Auch die Zahl ändert sich, siehe die Gutter-Größen weiter unten. |
col-xxl-4 | 2xl:col-4 | Das xxl von Bootstrap heißt in Tailwind 2xl. |
order-md-2 | md:order-2 | order-* kommt von Tailwind und geht bis 12. |
Gutter-Größen
| Bootstrap | Hier | Größe |
|---|---|---|
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 |
Utilities, die von Tailwind kommen
| Bootstrap | Hier | Hinweise |
|---|---|---|
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 | Abstands-Utilities verschieben sich genauso wie die Gutter. |
Breakpoints von Bootstrap nachbilden
Die Breakpoints von Bootstrap sind 576, 768, 992, 1200 und 1400px. Die von Tailwind sind 640, 768, 1024, 1280 und 1536px, ein Layout kann nach der Migration also etwas früher oder später umschalten. Wenn das wichtig ist, setze die Screens von Tailwind auf die Werte von 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 */
}Der container von Tailwind ist so breit wie der Breakpoint, auf dem er sitzt, seine Maximalbreiten werden also 576, 768, 992, 1200 und 1400px. Das ist nah an den 540, 720, 960, 1140 und 1320px von Bootstrap, aber nicht identisch.
Massenweise umbenennen
Dieser Perl-Befehl nummeriert die Gutter neu und macht aus col-md-6 md:col-6, aus col-xxl-4 2xl:col-4 und aus dem alten no-gutters g-0. Er schreibt die Dateien direkt um, committe also zuerst und lies danach den Diff.
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')Einmal ausführen und das Ergebnis prüfen
mb-3 oder p-3 brauchen also eine manuelle Runde, und das Muster trifft jeden Text, der wie eine Klasse aussieht, auch in Kommentaren.Was nicht übernommen wird
.container und .container-fluid hinzu, .container-sm, .container-md und die anderen responsiven Container von Bootstrap sind also nicht enthalten. Baue sie bei Bedarf mit den max-w-*-Utilities von Tailwind. Die übrigen Utilities von Bootstrap (Display, Flex, Abstand, Text) werden durch die von Tailwind ersetzt, wie in der letzten Tabelle oben.