Tailwind v4 sans Node
Chaque page ne compile que les classes qu’elle utilise, dans PHP.
Un réglage, aucune étape de compilation
Définissez tailwind.enabled dans blockstudio.json et écrivez des classes utilitaires dans n’importe quel modèle. À chaque requête de l’interface publique, Blockstudio rassemble les classes candidates dans le HTML final et compile exactement celles-ci avec TailwindPHP, un portage PHP de Tailwind CSS 4.3.
Il n’y a ni Node.js, ni CLI, ni observateur. Les classes des modèles de blocs, des modèles du thème, des extensions et de the_content sont toutes prises en compte, car la page entière est analysée.
{
"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>Aucun environnement Node
TailwindPHP compile à la requête ; rien n’est à compiler ni à déployer.
Utilitaires Tailwind 4.3
Utilitaires, variantes, valeurs arbitraires et directives de Tailwind CSS 4.3.
Analyse de toute la page
Les classes sont prises en compte où qu’elles apparaissent dans le HTML final.
Mis en cache par ensemble de classes
Les pages qui utilisent les mêmes classes partagent un fichier compilé.
Configuration axée sur CSS
Jetons @theme et règles @utility dans blockstudio.json ou dans un filtre.
Aperçu en direct dans l’éditeur
Une version intégrée pour le navigateur affiche un aperçu des classes pendant la saisie.
Sortie liée
Une feuille de style unique avec empreinte de contenu, que les navigateurs et les caches périphériques peuvent conserver.
Typographie et formulaires
Les deux extensions officielles sont portées vers PHP et chargées avec @plugin.
Configuré dans CSS
Tailwind v4 est configuré avec CSS, et non avec un fichier JavaScript. Ajoutez les jetons @theme, les règles @utility et les couches dans tailwind.config, ou ajoutez-les via le filtre blockstudio/tailwind/css lorsqu’ils s’étendent sur plusieurs lignes.
Les extensions officielles de typographie et de formulaires sont portées vers PHP et chargées avec @plugin. Les extensions disponibles uniquement sous forme de paquets JavaScript ne fonctionnent pas, car rien n’exécute Node.
Les alias de classe sont des règles @apply dans @layer utilities, comme un .btn créé à partir d’utilitaires d’espacement intérieur et de rayon. Ils sont compilés aussi bien sur le frontend que dans l’aperçu de l’éditeur.
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; } }"
}
}Les classes comme champ
Attribuez "tailwind": true à un champ classes : les éditeurs bénéficient alors de la complétion automatique de toute la liste de classes, et un aperçu intégré de Tailwind dans le navigateur affiche chaque modification sur le canevas.
Avec assets.reset.enabled, le canevas rétablit aussi les utilitaires d’affichage et de position, tels que flex, grid et sticky, que les règles du conteneur de l’éditeur remplaceraient autrement.
{
"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>Une feuille de style, mise en cache par ensemble de classes
Le CSS compilé est mis en cache sur le disque sous une clé construite à partir des classes candidates triées de la page et de l’entrée CSS. Les nonces et les horodatages ne l’invalident donc jamais, et les pages ayant les mêmes classes partagent un seul fichier.
La sortie intégrée est utilisée par défaut. "output": "link" émet plutôt ce fichier de cache sous forme de feuille de style avec empreinte de contenu. Mesuré sur une copie locale de ce site le 8 octobre, 2026, cela a réduit la taille de la page d’accueil de HTML à 296,379 octets, au lieu de 451,648.
Lorsque cache.path pointe vers un volume privé, Blockstudio utilise par défaut CSS en ligne, sauf si le filtre blockstudio/files/url renvoie un URL public pour la portée tailwind, par exemple un hôte CDN.
{
"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
);Fusionner les classes dans PHP
bs_tw_merge() résout les conflits entre utilitaires afin qu’une classe définie par l’auteur l’emporte sur une valeur par défaut. bs_tw_variants() renvoie une fonction de variante avec des classes de base, des variantes, des valeurs par défaut et des variantes composées.
Les deux utilisent le moteur TailwindPHP déjà intégré par Blockstudio : un thème n’a donc pas besoin d’en embarquer une copie.
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']);Purge à la demande
Runtime_Cache::purge(‘tailwind’) efface le CSS compilé ; la requête suivante le recompile.
Tampon de page facultatif
Un site qui n’utilise ni Tailwind ni assets de bloc peut désactiver le tampon de page avec le filtre blockstudio/buffer/enabled.
Isolation par source
Avec une source de découverte logique, la source sélectionnée et le contexte d’exécution sont intégrés à l’espace de noms du cache ; le dernier CSS valide ne fuit donc jamais entre les aperçus.
Ordre canonique des couches
Thème, base, composants, puis utilitaires, comme dans Tailwind CSS, afin que les couches ultérieures remplacent les précédentes.
Le kit d’extension officiel
Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.
- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord