Vai al contenuto

Tailwind v4 senza Node

Ogni pagina compila solo le classi che usa, in PHP.

Un’impostazione, nessuna fase di build

Impostate tailwind.enabled in blockstudio.json e scrivete classi di utilità in qualsiasi template. A ogni richiesta frontend, Blockstudio raccoglie i candidati di classe nel HTML completato e compila esattamente quelli con TailwindPHP, un porting PHP di Tailwind CSS 4.3.

Non servono Node.js, CLI né watcher. Si considerano le classi dei template dei blocchi, dei template del tema, dei plugin e di the_content, perché viene analizzata l’intera pagina.

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

Nessun runtime Node

TailwindPHP compila durante la richiesta: non c’è nulla da compilare o distribuire.

Utilità Tailwind 4.3

Utilità, varianti, valori arbitrari e direttive di Tailwind CSS 4.3.

Analisi dell’intera pagina

Le classi vengono conteggiate ovunque compaiano nel HTML finale.

Memorizzato in cache per insieme di classi

Le pagine che usano le stesse classi condividono un unico file compilato.

Configurazione con priorità a CSS

Token @theme e regole @utility in blockstudio.json o tramite un filtro.

Anteprima live nell’editor

Una build browser inclusa mostra un’anteprima delle classi mentre digitate.

Output collegato

Un unico foglio di stile con hash del contenuto, memorizzabile dai browser e dalle cache edge.

Tipografia e moduli

I due plugin ufficiali sono stati portati su PHP e vengono caricati con @plugin.

Configurazione in CSS

Tailwind v4 si configura con CSS, non con un file JavaScript. Inserite token @theme, regole @utility e livelli in tailwind.config, oppure aggiungeteli tramite il filtro blockstudio/tailwind/css quando si estendono su più righe.

I plugin ufficiali per tipografia e moduli sono stati portati su PHP e vengono caricati con @plugin. I plugin disponibili solo come pacchetti JavaScript non funzionano, perché non viene eseguito Node.

Gli alias di classe sono regole @apply dentro @layer utilities, come un .btn creato con utility per padding e raggio. Vengono compilati sia nel frontend sia nell’anteprima dell’editor.

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

Le classi come campo

Assegnate a un campo classes il tipo "tailwind": true: chi modifica i contenuti riceverà il completamento automatico dall’elenco completo delle classi e un’anteprima nel canvas di ogni modifica grazie a una build browser Tailwind inclusa.

Con assets.reset.enabled, il canvas ripristina anche le utilità di visualizzazione e posizione come flex, grid e sticky, che altrimenti verrebbero sovrascritte dalle regole del wrapper dell’editor.

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

Un foglio di stile, memorizzato in cache per insieme di classi

Il codice CSS compilato viene memorizzato su disco con una chiave ricavata dai candidati di classe ordinati della pagina e dall’input CSS: nonce e timestamp non invalidano mai la cache e le pagine con le stesse classi condividono lo stesso file.

L’output inline è l’impostazione predefinita. "output": "link" emette invece il file della cache come foglio di stile con hash del contenuto. In una misurazione effettuata su una copia locale di questo sito l’8 ottobre, 2026, la home page è passata da 451,648 a 296,379 byte grazie a HTML.

Quando cache.path punta a un volume privato, Blockstudio ripiega su CSS inline, a meno che il filtro blockstudio/files/url non restituisca un URL pubblico per l’ambito tailwind, ad esempio un host CDN.

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

Unisci le classi in PHP

bs_tw_merge() risolve i conflitti tra le utilità, dando priorità a una classe definita dall’utente rispetto a una predefinita. bs_tw_variants() restituisce una funzione di variante con classi base, varianti, valori predefiniti e varianti composte.

Entrambi usano il motore TailwindPHP già incluso in Blockstudio, quindi un tema non ha bisogno di una copia propria.

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']);

Svuotamento su richiesta

Runtime_Cache::purge(‘tailwind’) cancella il CSS compilato, che verrà ricompilato alla richiesta successiva.

Buffer di pagina facoltativo

Un sito che non usa né Tailwind né asset dei blocchi può disattivare il buffer di pagina con il filtro blockstudio/buffer/enabled.

Isolato per sorgente

Con una sorgente di rilevamento logica, la sorgente selezionata e il contesto di runtime entrano nello spazio dei nomi della cache, così l’ultimo CSS valido non trapela tra le anteprime.

Ordine canonico dei livelli

Tema, base, componenti e poi utility, come in Tailwind CSS, così i livelli successivi sovrascrivono quelli precedenti.

Plus

Il kit ufficiale di estensioni

Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.

  • Oltre 500 modelli di siti
  • Istruzioni di sistema per l’AI
  • Aggiornamenti a vita
  • Community privata di Discord