Aller au contenu

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.

blockstudio.json
{
  "tailwind": {
    "enabled": true
  }
}

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.

functions.php
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;
    }
  ';
});

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.

block.json
{
  "name": "acme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      {
        "id": "classes",
        "type": "classes",
        "label": "Classes",
        "tailwind": true,
        "default": "bg-white text-gray-900"
      }
    ]
  }
}

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.

blockstudio.json
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}

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.

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

Plus

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