# Tailwind v4 fără Node

Fiecare pagină compilează doar clasele pe care le folosește, în PHP.

## O singură setare, fără pas de compilare

Setați `tailwind.enabled` în `blockstudio.json` și scrieți clase utilitare în orice șablon. La fiecare cerere pentru partea frontală, Blockstudio colectează candidații pentru clase din HTML finalizat și le compilează exact pe acestea cu TailwindPHP, un port PHP al Tailwind CSS 4.3.

Nu există Node.js, CLI sau un proces de urmărire. Clasele din șabloanele blocurilor, șabloanele temei, pluginuri și `the_content` sunt toate luate în calcul, deoarece este scanată întreaga pagină.

[Activarea Tailwind](https://blockstudio.dev/ro/docs/tailwind/#enabling-tailwind)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true
  }
}
```

## Fără mediu de execuție Node

TailwindPHP compilează la fiecare cerere; nu este nimic de compilat sau implementat.

## Utilitare Tailwind 4.3

Utilitare, variante, valori arbitrare și directive din Tailwind CSS 4.3.

## Scanarea întregii pagini

Clasele sunt luate în calcul oriunde apar în HTML final.

## Memorat în cache după setul de clase

Paginile care folosesc aceleași clase partajează un singur fișier compilat.

## Configurație cu prioritate pentru CSS

Tokenuri @theme și reguli @utility în blockstudio.json sau într-un filtru.

## Previzualizare live în editor

O versiune pentru browser, inclusă în pachet, previzualizează clasele pe măsură ce tastați.

## Ieșire asociată

O singură foaie de stil cu hash de conținut, pe care browserele și cache-urile edge o pot păstra.

## Tipografie și formulare

Cele două pluginuri oficiale sunt portate la PHP și se încarcă cu @plugin.

## Configurat în CSS

Tailwind v4 este configurat cu CSS, nu cu un fișier JavaScript. Adăugați tokenurile `@theme`, regulile `@utility` și straturile în `tailwind.config` sau adăugați-le prin filtrul `blockstudio/tailwind/css` atunci când sunt pe mai multe rânduri.

Pluginurile oficiale de tipografie și formulare sunt portate la PHP și se încarcă cu `@plugin`. Pluginurile disponibile doar ca pachete JavaScript nu rulează, deoarece nu se execută nimic în Node.

Aliasurile de clase sunt reguli `@apply` în `@layer utilities`, precum un `.btn` creat din utilitare de spațiere interioară și rază. Se compilează atât în frontend, cât și în previzualizarea editorului.

[Configurare](https://blockstudio.dev/ro/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;
    }
  ';
});
```

## Clasele ca câmp

Adăugați `"tailwind": true` unui câmp `classes`, iar editorii vor beneficia de completare automată din lista completă de clase; o versiune Tailwind pentru browser, inclusă în pachet, previzualizează fiecare modificare în pânză.

Cu `assets.reset.enabled`, pânza restabilește și utilitarele de afișare și poziționare, precum `flex`, `grid` și `sticky`, pe care regulile de încadrare ale editorului le-ar suprascrie altfel.

[Tipul câmpului Classes](https://blockstudio.dev/ro/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"
      }
    ]
  }
}
```

## O singură foaie de stil, memorată în cache după setul de clase

CSS compilat este memorat pe disc sub o cheie creată din candidații de clase sortați ai paginii și intrarea CSS, astfel încât nonce-urile și marcajele temporale nu invalidează niciodată memoria cache, iar paginile cu aceleași clase partajează un singur fișier.

Ieșirea inline este implicită. `"output": "link"` generează în schimb fișierul din memoria cache ca foaie de stil cu hash de conținut. Măsurat pe o copie locală a acestui site, pe 8 octombrie, 2026, a redus dimensiunea paginii principale de la 451,648 la 296,379 octeți, pornind de la HTML.

Când `cache.path` indică spre un volum privat, Blockstudio revine la CSS inline, cu excepția cazului în care filtrul `blockstudio/files/url` returnează un URL public pentru domeniul `tailwind`, de exemplu o gazdă CDN.

[Ieșire pentru partea frontală](https://blockstudio.dev/ro/docs/tailwind/#frontend-output)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}
```

## Îmbinați clase în PHP

`bs_tw_merge()` rezolvă conflictele dintre utilitare, astfel încât o clasă definită explicit să aibă prioritate față de una implicită. `bs_tw_variants()` returnează o funcție variantă apelabilă, cu clase de bază, variante, valori implicite și variante compuse.

Ambele folosesc motorul TailwindPHP pe care Blockstudio îl include deja, astfel încât o temă nu are nevoie de propria copie.

[Funcții ajutătoare pentru șabloane](https://blockstudio.dev/ro/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']);
```

## Golire la cerere

Runtime_Cache::purge(‘tailwind’) șterge CSS compilat, iar la următoarea solicitare acesta este compilat din nou.

## Buffer opțional pentru pagină

Un site care nu folosește nici Tailwind, nici resurse pentru blocuri poate dezactiva bufferul paginii cu filtrul blockstudio/buffer/enabled.

## Izolat pentru fiecare sursă

Cu o sursă logică de descoperire, sursa selectată și contextul de execuție intră în spațiul de nume al cache-ului, astfel încât CSS cu ultima versiune validă să nu se scurgă între previzualizări.

## Ordine canonică a straturilor

Temă, bază, componente, apoi utilitare, ca în Tailwind CSS, astfel încât straturile ulterioare să le suprascrie pe cele anterioare.

Plus

## Kitul oficial de extensii

Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.

- 500+ șabloane de site
- Instrucțiuni de sistem pentru IA
- Actualizări pe viață
- Comunitate privată Discord

[Obțineți Plus](https://blockstudio.dev/ro/plus/)
