Wenn du schon in Zeilen und Spalten denkst, mach einfach weiter so. tw-bootstrap-grid bringt das vertraute 12-Spalten-Grid mit .row, .col-6, .offset-2 und .g-4 zu Tailwind, mit RTL-Unterstützung und ohne Vorgaben, wie deine Komponenten aussehen sollen.
.row, .col, .col-auto und .col-1 bis .col-12, genau wie bei Bootstrap.
Gutter aus deinem Theme
.g-*, .gx-* und .gy-* nutzen deine Tailwind-Abstandsskala und passen so zum Rest deines Designs.
Offsets
.offset-0 bis .offset-12, um eine Spalte zu zentrieren oder eine Lücke zu lassen.
Spalten pro Zeile
.row-cols-1 bis .row-cols-6 und .row-cols-auto bestimmen die Breite aller Kinder mit einer einzigen Klasse an der Zeile.
Container
.container und .container-fluid mit Innenabstand, der den Gutter berücksichtigt. Die maximalen Breiten kommen von den Breakpoints von Tailwind.
Responsive und RTL
Jede Klasse akzeptiert die Breakpoint-Präfixe von Tailwind, etwa md:col-6, und dreht sich mit dir="rtl" korrekt um.
Es kümmert sich nur um das Layout: keine Farben, keine Komponenten, keine Resets. Es ergänzt Tailwind, statt etwas zu ersetzen, du kannst also col-4 und flex ohne Bedenken auf derselben Seite mischen.
Erste Schritte
Installation
Drei Schritte: Paket installieren, Plugin registrieren, die Klassen benutzen.
1Paket installieren
npm install tw-bootstrap-grid
2Plugin registrieren
Wähle oben deine Tailwind-Version, dann passt sich das Snippet darunter an. Tailwind v4 registriert Plugins im CSS, v3 in der Konfigurationsdatei.
Das Plugin läuft im Compiler von Tailwind (PostCSS, Vite, Webpack, die Tailwind-CLI …). Mit dem Tailwind-Play-CDN-Skript funktioniert es nicht, denn das kann keine Plugins aus npm laden.
Erste Schritte
Konfiguration
Die Standardwerte entsprechen Bootstrap, du kannst diese Seite also überspringen. Komm zurück, wenn du andere Breakpoints oder Gutter-Größen willst.
Breakpoints
Das Plugin hat keine eigenen Breakpoints. Präfixe wie md:col-6 und die Maximalbreite von .container kommen beide von Tailwind. Ändern sich deine Screens, ändert sich also auch das Grid.
Gutter sind der Abstand zwischen den Spalten. Standardmäßig sind es 1.5rem horizontal und 0 vertikal. Du kannst ihn einmal für alles festlegen oder getrennt für Container und Zeilen. In v3 übergibst du dem Plugin Optionen, in v4 setzt du CSS-Variablen.
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;
}
Reihenfolge der Gutter-Auflösung
Priorität
CSS-Variable
Option
Hinweise
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
Der spezifischste Wert gewinnt.
2
--bs-global-gutter-x
gutters
Gemeinsamer Fallback für beide.
3
1.5rem (x) und 0 (y)
eingebauter Standard
Dieselben Standardwerte wie bei Bootstrap.
Die CSS-Variablen werden zur Laufzeit gelesen. In beiden Versionen kannst du sie deshalb auch an jedem Element überschreiben, um die Gutter nur für diesen Abschnitt zu ändern. Für eine einzelne Zeile nimmst du .g-*, .gx-* und .gy-*.
Container ausschalten
Du möchtest nur den container von Tailwind verwenden? Setze generateContainers auf false, dann erzeugt das Plugin .container-fluid und den Innenabstand mit Gutter-Bezug nicht mehr. Zeilen und Spalten bleiben unberührt.
Tailwind v4 kann einem Plugin einfache Werte wie generateContainers: false; übergeben, aber keine verschachtelten Objekte wie gutters. CSS-Variablen decken diesen Fall ab und lassen sich obendrein pro Element überschreiben.
Referenz
Klassen
Alles, was das Plugin hinzufügt, an einem Ort.
Layout
Layout-Klassen
Klasse
Was sie tut
Hinweise
.container
width: 100%; zentriert; Innenabstand aus dem Gutter
Die Maximalbreite kommt von den Breakpoints von Tailwind.
Hebt den äußeren Gutter auf und ordnet die Kinder an.
Spalten
Spalten-Klassen
Klasse
Was sie tut
Hinweise
.col
flex: 1 0 0%
Teilt den restlichen Platz gleichmäßig auf.
.col-auto
flex: 0 0 auto; width: auto
Richtet sich nach ihrem Inhalt.
.col-1 … .col-12
flex: 0 0 auto; width: n / 12
Belegt n von 12 Teilen.
Offsets und Spalten pro Zeile
Offsets und Spalten pro Zeile-Klassen
Klasse
Was sie tut
Hinweise
.offset-0 … .offset-12
margin-inline-start: n / 12
Dreht sich in RTL automatisch um.
.row-cols-1 … .row-cols-6
Kinder erhalten width: 1 / n
Wird an der .row gesetzt und gilt für jedes Kind.
.row-cols-auto
Kinder erhalten width: auto
Die Kinder richten sich nach ihrem Inhalt.
Gutter
Gutter-Klassen
Klasse
Was sie tut
Hinweise
.g-*
--bs-gutter-x und --bs-gutter-y
Beide Richtungen.
.gx-*
--bs-gutter-x
Nur horizontal.
.gy-*
--bs-gutter-y
Nur vertikal.
Alles ist responsive
Setze ein Breakpoint-Präfix vor jede der Klassen oben: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.
Welche Gutter-Stufen gibt es?
.g-*, .gx-* und .gy-* werden aus deinem Abstands-Theme erzeugt. In v3 ist das jeder Schlüssel von theme.spacing ohne Punkt (also g-4 ja, g-0.5 nein). In v4 ist es die Standardskala, g-0 bis g-96 und g-px.
Ausrichtung und Reihenfolge kommen von Tailwind
Das Plugin bringt keine eigenen justify-*, items-* oder order-* mit. Eine .row ist ein gewöhnlicher Flex-Container, die Utilities von Tailwind funktionieren also direkt darauf.
Du kommst von Bootstrap?
Migration von Bootstrap
Das Grid funktioniert so, wie du es kennst. Drei Dinge sehen anders aus: wie responsive Klassen geschrieben werden, die Abstandszahlen und die Breakpoint-Breiten.
Was gleich bleibt
Die Struktur: .container, .row, .col-*, .offset-*, .row-cols-*. Sogar die CSS-Variablen behalten ihre Namen, --bs-gutter-x und --bs-gutter-y, eigenes CSS, das sie liest, funktioniert also weiter.
Präfix statt Infix
Bootstrap schreibt col-md-6. Tailwind schreibt md: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-3 von Bootstrap ist hier also g-4. Auch die Breakpoint-Breiten weichen etwas ab.
Die ganze Anleitung enthält die Zuordnungstabellen, die Änderungen bei den Gutter-Größen, wie du die Breakpoints von Bootstrap nachbildest und einen Befehl, der dein Markup umwandelt.
Jedes Beispiel ist live. Bearbeite links das HTML, die Vorschau aktualisiert sich beim Tippen. Wenn du das Bootstrap-Grid (öffnet in einem neuen Tab) kennst, wird dir das vertraut vorkommen.
Ein einfaches Layout
Ein .container zentriert deinen Inhalt, eine .row ordnet Spalten nebeneinander an und jede .col-* belegt so viele der 12 verfügbaren Teile. Zwei col-6-Spalten teilen die Zeile in zwei Hälften.
Vorschau
Bearbeitbares HTML
Spalten brechen immer um. Alles, was in einer Zeile über 12 Teile hinausgeht, rutscht in die nächste Zeile, das ist praktisch für Kartenlisten.
Gleich breite und automatisch breite Spalten
Ein einfaches .col teilt sich den verbleibenden Platz, drei davon sind also drei gleich breite Spalten. .col-auto richtet sich nach seinem Inhalt, das benachbarte .col nimmt den Rest.
Vorschau
Bearbeitbares HTML
Responsive Spalten
Jede Klasse akzeptiert die Breakpoint-Präfixe von Tailwind. Beginne mobil mit col-12 und ändere die Breite auf größeren Bildschirmen mit sm:, md:, lg: und so weiter. Mit den Breitenbuttons über der Vorschau siehst du, wie jeder Breakpoint greift.
Vorschau
768px · md · 0%
Bearbeitbares HTML
Die Vorschau ist ein echter Viewport. Sie zeigt Breite und Breakpoint in der Ecke an, und die Buttons für Smartphone, Tablet und Desktop schalten sie um, md: und lg: greifen also genau wie auf diesem Bildschirm.
Gutter
Gutter sind die Lücken zwischen den Spalten. .g-* setzt beide Richtungen, .gx-* nur die horizontale und .gy-* nur die vertikale. Die Zahlen stammen aus der Abstandsskala von Tailwind, g-4 ist also dieselbe Stufe wie p-4.
Vorschau
Bearbeitbares HTML
Setze Gutter-Klassen an die .row. Mit g-0 entfernst du die Lücken ganz.
Offsets
.offset-* schiebt eine Spalte um so viele Teile zur Seite. So zentrierst du schnell eine Spalte oder lässt eine Lücke. Offsets funktionieren auch mit Breakpoint-Präfixen, etwa lg:offset-3.
Vorschau
Bearbeitbares HTML
Offsets verwenden margin-inline-start, sie schieben also von der richtigen Seite, wenn die Seite von rechts nach links läuft. Probiere den RTL-Button über der Vorschau aus.
Spalten pro Zeile
Wenn alle Spalten gleich groß sind, lege das einmal an der Zeile fest statt an jedem Kind. .row-cols-1 bis .row-cols-6 geben jedem Kind einen gleichen Anteil, .row-cols-auto richtet sie nach dem Inhalt.
Vorschau
Bearbeitbares HTML
Kombiniere es mit Breakpoints, um die Spaltenzahl mit wachsendem Bildschirm zu ändern, zum Beispiel row-cols-2 lg:row-cols-3.
Verschachtelung
Eine Spalte kann ihre eigene .row enthalten. Die verschachtelte Zeile beginnt ein neues 12-teiliges Grid innerhalb der Spalte, du kannst einen Bereich also beliebig oft teilen.
Vorschau
Bearbeitbares HTML
Ausrichtung und Reihenfolge
Eine .row ist ein normaler Flex-Container, die Flexbox-Utilities von Tailwind funktionieren also darauf: items-*, justify-*, self-* und order-*. Das Plugin definiert sie nicht neu.
Vorschau
Bearbeitbares HTML
Tausch im Stil von order-2 md:order-1 ist ein verbreitetes Muster: auf dem Smartphone in einer Reihenfolge stapeln, auf größeren Bildschirmen umkehren.
Von rechts nach links
Setze dir="rtl" am Container oder für die ganze Seite an <html>, dann fließt das Grid von rechts. Das ist die Wahl für Arabisch, Persisch, Hebräisch und andere RTL-Sprachen.
Vorschau
Bearbeitbares HTML
Es gibt nichts zu konfigurieren. Die Gutter der Zeile sind symmetrisch und Offsets verwenden logische Eigenschaften, sie drehen sich also von selbst um.
Gut zu wissen
Von rechts nach links
Füge dir="rtl" hinzu, und das Grid spiegelt sich. Es gibt nichts zu konfigurieren.
Für die ganze Seite
index.html
<html dir="rtl">
...
</html>
Für einen Abschnitt
index.html
<div class="container" dir="rtl">
<div class="row">
<div class="col-6 offset-3">Starts from the right</div>
</div>
</div>
Warum es einfach funktioniert
Offsets verwenden margin-inline-start, und die negativen Außenabstände der Zeile sowie der Innenabstand der Spalten sind symmetrisch, sie drehen sich also von selbst um. Mit dem RTL-Button an jedem Beispiel oben siehst du es.
Gut zu wissen
Häufig gestellte Fragen
Antworten auf die Fragen, die am häufigsten auftauchen.
Nein. Der container von Tailwind liefert weiterhin die Maximalbreiten pro Breakpoint. Das Plugin ergänzt darüber Zentrierung und einen Innenabstand mit Gutter-Bezug. Wenn du das nicht möchtest, setze generateContainers auf false.
Ja, genau das ist die Idee. Eine .row ist ein Flex-Container, items-center, justify-between, order-2, mt-4 und der Rest gelten also wie gewohnt für sie und ihre Spalten.
Tailwind erzeugt nur CSS für Klassen, die es in deinen Quelldateien findet. In deinem eigenen Projekt geschieht das automatisch. Auf dieser Seite können die bearbeitbaren Beispiele alles enthalten, deshalb erzeugt die Demo vorab jede Klasse und jeden Breakpoint des Plugins.
Nein. Das CDN-Skript kann keine Plugins aus npm laden. Nutze ein Build-Setup wie Vite, PostCSS, Webpack oder die Tailwind-CLI.
Tailwind v3.4 und v4, mit Node 18 oder neuer. Das Paket enthält ESM- und CommonJS-Builds mit TypeScript-Typen.
Die Klassennamen sind sich ähnlich: col-md-6 wird zu md:col-6, und die Gutter-Zahlen folgen der Skala von Tailwind. Die Migrationsanleitung enthält die vollständige Zuordnung und einen Befehl, der dein Markup umwandelt.