Gå til indhold

Tailwind v4 uden Node

Hver side kompilerer kun de klasser, den bruger, i PHP.

Én indstilling, intet build-trin

Angiv tailwind.enabled i blockstudio.json, og skriv utility-klasser i enhver skabelon. Ved hver frontend-forespørgsel indsamler Blockstudio klassekandidaterne i den færdige HTML og kompilerer præcis dem med TailwindPHP, en PHP-portering af Tailwind CSS 4.3.

Der er ingen Node.js, ingen CLI og ingen watcher. Klasser fra blokskabeloner, temaskabeloner, plugins og the_content tæller alle med, fordi hele siden scannes.

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

Ingen Node-runtime

TailwindPHP kompilerer ved forespørgslen; der er intet at bygge eller deploye.

Tailwind 4.3-værktøjer

Værktøjer, varianter, vilkårlige værdier og direktiver fra Tailwind CSS 4.3.

Scanning af hele siden

Klasser tæller med, uanset hvor de optræder i den endelige HTML.

Cachelagret efter klassesæt

Sider med de samme klasser deler én kompileret fil.

CSS-først-konfiguration

@theme-tokens og @utility-regler i blockstudio.json eller et filter.

Direkte forhåndsvisning i editoren

En medfølgende browserbuild viser klasserne, mens du skriver.

Sammenkædet output

Ét content-hash’et stylesheet, som browsere og edge-caches kan gemme.

Typografi og formularer

De to officielle plugins er porteret til PHP og indlæses med @plugin.

Konfigureret i CSS

Tailwind v4 konfigureres med CSS, ikke en JavaScript-fil. Placer @theme-tokens, @utility-regler og lag i tailwind.config, eller tilføj dem via blockstudio/tailwind/css-filteret, når de strækker sig over flere linjer.

De officielle typografi- og formularplugins er porteret til PHP og indlæses med @plugin. Plugins, der kun findes som JavaScript-pakker, kører ikke, fordi intet afvikler Node.

Klassealiasser er @apply-regler i @layer utilities, såsom en .btn bygget af padding- og radius-utilities. De kompileres både på frontend og i editorens forhåndsvisning.

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

Klasser som felt

Giv et classes-felt "tailwind": true, så får redaktører autofuldførelse fra hele klasselisten, mens en medfølgende Tailwind-browserbuild viser hver ændring på lærredet.

Med assets.reset.enabled gendanner lærredet også visnings- og positionsværktøjer som flex, grid og sticky, som editorens wrapper-regler ellers ville tilsidesætte.

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

Ét stylesheet, cachelagret efter klassesæt

Kompileret CSS cachelagres på disken med en nøgle, der er baseret på sidens sorterede klassekandidater og inputtet CSS, så nonces og tidsstempler aldrig ugyldiggør det, og sider med de samme klasser deler én fil.

Inline-output er standard. "output": "link" udsender i stedet cachefilen som et content-hash’et stylesheet. Ved måling på en lokal kopi af dette websted den 8. oktober 2026 tog det hjemmesiden fra 451,648 til 296,379 bytes med HTML.

Når cache.path peger på et privat volumen, falder Blockstudio tilbage til inline CSS, medmindre filteret blockstudio/files/url returnerer en offentlig URL for scopet tailwind, såsom en CDN-vært.

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

Sammenflet klasser i PHP

bs_tw_merge() løser konflikter mellem utility-klasser, så en brugerdefineret klasse vinder over en standardklasse. bs_tw_variants() returnerer en variantfunktion med basisklasser, varianter, standardindstillinger og sammensatte varianter.

Begge bruger den TailwindPHP-motor, som Blockstudio allerede indeholder, så et tema behøver ikke sin egen kopi.

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

Ryd efter behov

Runtime_Cache::purge(‘tailwind’) rydder den kompilerede CSS, og den næste anmodning kompilerer den igen.

Valgfri sidebuffer

Et websted, der hverken bruger Tailwind eller blokaktiver, kan slå sidebufferen fra med filteret blockstudio/buffer/enabled.

Isoleret pr. kilde

Med en logisk opdagelseskilde indgår den valgte kilde og runtimekonteksten i cachenavnerummet, så den senest fungerende CSS aldrig lækker mellem forhåndsvisninger.

Kanonisk lagrækkefølge

Tema, base, komponenter og derefter utilities, som i Tailwind CSS, så senere lag tilsidesætter tidligere.

Plus

Det officielle udvidelsessæt

Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.

  • 500+ hjemmesideskabeloner
  • AI-systeminstruktioner
  • Opdateringer hele livet
  • Privat Discord-fællesskab