Tailwind-CSS-Plugin · v1.4.2

Das Bootstrap-Grid, für Tailwind.

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.

$npm install tw-bootstrap-grid

Was du bekommst

  • 12-Spalten-Grid

    .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.

Tailwind v4

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

In einer v3-Konfiguration mit CommonJS funktioniert auch plugins: [require("tw-bootstrap-grid")].

3Klassen verwenden

Das war's schon. Nutze sie in deinem Markup wie jede andere Tailwind-Klasse. Alles, was mit sm:, md: oder hover: geht, funktioniert auch hier.

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>

Du brauchst einen Build-Schritt

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.

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

Gutter-Größen

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ätCSS-VariableOptionHinweise
1--bs-row-gutter-x / --bs-container-gutter-xrowGutters / containerGuttersDer spezifischste Wert gewinnt.
2--bs-global-gutter-xguttersGemeinsamer Fallback für beide.
31.5rem (x) und 0 (y)eingebauter StandardDieselben 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

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

Warum Variablen in v4?

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
KlasseWas sie tutHinweise
.containerwidth: 100%; zentriert; Innenabstand aus dem GutterDie Maximalbreite kommt von den Breakpoints von Tailwind.
.container-fluidwie .containerVolle Breite bei jedem Breakpoint.
.rowdisplay: flex; flex-wrap: wrap; negative AußenabständeHebt den äußeren Gutter auf und ordnet die Kinder an.

Spalten

Spalten-Klassen
KlasseWas sie tutHinweise
.colflex: 1 0 0%Teilt den restlichen Platz gleichmäßig auf.
.col-autoflex: 0 0 auto; width: autoRichtet sich nach ihrem Inhalt.
.col-1 … .col-12flex: 0 0 auto; width: n / 12Belegt n von 12 Teilen.

Offsets und Spalten pro Zeile

Offsets und Spalten pro Zeile-Klassen
KlasseWas sie tutHinweise
.offset-0 … .offset-12margin-inline-start: n / 12Dreht sich in RTL automatisch um.
.row-cols-1 … .row-cols-6Kinder erhalten width: 1 / nWird an der .row gesetzt und gilt für jedes Kind.
.row-cols-autoKinder erhalten width: autoDie Kinder richten sich nach ihrem Inhalt.

Gutter

Gutter-Klassen
KlasseWas sie tutHinweise
.g-*--bs-gutter-x und --bs-gutter-yBeide Richtungen.
.gx-*--bs-gutter-xNur horizontal.
.gy-*--bs-gutter-yNur 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.

Zur Migrationsanleitung

Anwendung

Beispiele

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.

Einen Fehler gefunden oder eine Idee?

Eröffne ein Issue (öffnet in einem neuen Tab) oder schicke einen Pull Request (öffnet in einem neuen Tab) auf GitHub. Kleine Korrekturen und Verbesserungen an der Dokumentation sind sehr willkommen.