Tailwind v4 ohne Node
Jede Seite kompiliert nur die Klassen, die sie verwendet, in PHP.
Eine Einstellung, kein Build-Schritt
Lege tailwind.enabled in blockstudio.json fest und schreibe Utility-Klassen in beliebige Templates. Bei jeder Frontend-Anfrage sammelt Blockstudio die Klassenkandidaten im fertigen HTML und kompiliert mit TailwindPHP genau diese – einer PHP-Portierung von Tailwind CSS 4.3.
Es gibt weder Node.js noch CLI noch einen Watcher. Klassen aus Block-Templates, Theme-Templates, Plugins und the_content zählen alle, weil die gesamte Seite durchsucht wird.
{
"tailwind": {
"enabled": true
}
}<section class="bg-slate-950 px-6 py-24">
<h1 class="text-5xl font-semibold tracking-tight text-white">
<?php echo esc_html( $a['title'] ); ?>
</h1>
</section>Keine Node-Laufzeit
TailwindPHP kompiliert während der Anfrage; es gibt nichts zu bauen oder bereitzustellen.
Tailwind-4.3-Utilities
Utilities, Varianten, beliebige Werte und Direktiven aus Tailwind CSS 4.3.
Seitenweite Suche
Klassen zählen überall dort, wo sie im fertigen HTML vorkommen.
Nach Klassensatz gecacht
Seiten mit denselben Klassen teilen sich eine kompilierte Datei.
CSS-First-Konfiguration
@theme-Tokens und @utility-Regeln in blockstudio.json oder einem Filter.
Live-Vorschau im Editor
Eine gebündelte Browserversion zeigt Klassen während der Eingabe in der Vorschau.
Verknüpfte Ausgabe
Ein inhaltsgehashtes Stylesheet, das Browser und Edge-Caches vorhalten können.
Typography und Forms
Die beiden offiziellen Plugins wurden auf PHP portiert und werden mit @plugin geladen.
Konfiguriert in CSS
Tailwind v4 wird mit CSS konfiguriert, nicht mit einer JavaScript-Datei. Füge @theme-Tokens, @utility-Regeln und Ebenen in tailwind.config ein oder ergänze sie über den blockstudio/tailwind/css-Filter, wenn sie sich über mehrere Zeilen erstrecken.
Die offiziellen Typography- und Forms-Plugins wurden auf PHP portiert und werden mit @plugin geladen. Plugins, die nur als JavaScript-Pakete verfügbar sind, laufen nicht, da nichts Node ausführt.
Klassen-Aliase sind @apply-Regeln innerhalb von @layer utilities, zum Beispiel ein .btn aus Padding- und Radius-Utilities. Sie werden sowohl im Frontend als auch in der Editor-Vorschau kompiliert.
add_filter('blockstudio/tailwind/css', function (string $css): string {
return $css . '
@plugin "@tailwindcss/typography";
@theme { --color-brand: #4f46e5; }
@utility container-narrow {
max-width: 48rem;
margin-inline: auto;
}
';
});{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } }"
}
}Klassen als Feld
Gib einem classes-Feld "tailwind": true, und Redakteure erhalten Autovervollständigung aus der vollständigen Klassenliste. Eine gebündelte Tailwind-Browserversion zeigt jede Änderung auf der Leinwand in der Vorschau.
Mit assets.reset.enabled stellt die Leinwand außerdem Anzeige- und Positions-Utilities wie flex, grid und sticky wieder her, die sonst von den Editor-Wrapper-Regeln überschrieben würden.
{
"name": "acme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}<div class="<?php echo esc_attr( $a['classes'] ); ?>">
<InnerBlocks />
</div>Ein Stylesheet, nach Klassensatz gecacht
Kompiliertes CSS wird auf dem Datenträger unter einem Schlüssel gecacht, der aus den sortierten Klassenkandidaten der Seite und der Eingabe CSS gebildet wird. So machen Nonces und Zeitstempel den Cache nie ungültig, und Seiten mit denselben Klassen teilen sich eine Datei.
Die Inline-Ausgabe ist der Standard. "output": "link" gibt stattdessen diese Cache-Datei als inhaltsgehashtes Stylesheet aus. Bei einer Messung an einer lokalen Kopie dieser Website am 8. Oktober 2026 sank die Größe der Startseite dadurch von HTML 451,648 auf 296,379 Bytes.
Wenn cache.path auf ein privates Volume verweist, wechselt Blockstudio zu Inline-CSS, sofern der blockstudio/files/url-Filter nicht ein öffentliches URL für den Geltungsbereich tailwind zurückgibt, etwa einen CDN-Host.
{
"tailwind": {
"enabled": true,
"output": "link"
}
}add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope): string {
if ('tailwind' !== $scope) {
return $url;
}
return 'https://static.example.com/blockstudio/' . basename($path);
},
10,
3
);Klassen in PHP zusammenführen
bs_tw_merge() löst widersprüchliche Utilities auf, sodass eine selbst definierte Klasse Vorrang vor einem Standardwert hat. bs_tw_variants() gibt eine Variant-Funktion mit Basisklassen, Varianten, Standardwerten und kombinierten Varianten zurück.
Beide verwenden die Engine TailwindPHP, die Blockstudio bereits bündelt. Daher braucht ein Theme keine eigene Kopie.
echo bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);Bei Bedarf leeren
Runtime_Cache::purge(‘tailwind’) löscht das kompilierte CSS; bei der nächsten Anfrage wird es erneut kompiliert.
Optionaler Seitenpuffer
Eine Website, die weder Tailwind noch Block-Assets verwendet, kann den Seitenpuffer mit dem Filter blockstudio/buffer/enabled deaktivieren.
Pro Quelle isoliert
Bei einer logischen Erkennungsquelle werden die ausgewählte Quelle und der Laufzeitkontext Teil des Cache-Namespace, sodass zuletzt erfolgreiche CSS-Ergebnisse nicht zwischen Vorschauen durchsickern.
Kanonische Ebenenreihenfolge
Theme, Basis, Komponenten, dann Utilities wie in Tailwind CSS, sodass spätere Ebenen frühere überschreiben.
Das offizielle Erweiterungspaket
Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.
- 500+ Website-Vorlagen
- KI-Systemanweisungen
- Updates auf Lebenszeit
- Private Discord-Community