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

[Activation de Tailwind](https://blockstudio.dev/fr/docs/tailwind/#enabling-tailwind)

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.

[Configuration](https://blockstudio.dev/fr/docs/tailwind/#configuration)

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.

[Type de champ Classes](https://blockstudio.dev/fr/docs/tailwind/#classes-field-type)

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.

[Sortie pour l’interface publique](https://blockstudio.dev/fr/docs/tailwind/#frontend-output)

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.

[Assistants de modèle](https://blockstudio.dev/fr/docs/tailwind/#template-composition-helpers)

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

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
