Hoppa till innehåll

Tailwind v4 utan Node

Varje sida kompilerar endast de klasser den använder, i PHP.

En inställning, inget byggsteg

Ange tailwind.enabled i blockstudio.json och skriv utility-klasser i valfri mall. Vid varje frontend-förfrågan samlar Blockstudio in klasskandidaterna i den färdiga HTML och kompilerar exakt dessa med TailwindPHP, en PHP-portering av Tailwind CSS 4.3.

Det finns ingen Node.js, ingen CLI och ingen bevakare. Klasser från blockmallar, temamallar, tillägg och the_content räknas alla, eftersom hela sidan genomsöks.

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

Ingen Node-körmiljö

TailwindPHP kompilerar under förfrågan; inget behöver byggas eller driftsättas.

Tailwind 4.3-verktyg

Verktyg, varianter, godtyckliga värden och direktiv från Tailwind CSS 4.3.

Genomsökning av hela sidan

Klasser räknas oavsett var de förekommer i den slutliga HTML.

Cachelagras efter klassuppsättning

Sidor som använder samma klasser delar en kompilerad fil.

Konfiguration med CSS i första hand

@theme-token och @utility-regler i blockstudio.json eller ett filter.

Direktförhandsvisning i redigeraren

En medföljande webbläsarversion förhandsvisar klasser medan du skriver.

Länkad utdata

En innehållshashad formatmall som webbläsare och edge-cachar kan behålla.

Typografi och formulär

De två officiella tilläggen har porterats till PHP och läses in med @plugin.

Konfigureras i CSS

Tailwind v4 konfigureras med CSS, inte en JavaScript-fil. Lägg till @theme-token, @utility-regler och lager i tailwind.config, eller lägg till dem via filtret blockstudio/tailwind/css när de sträcker sig över flera rader.

De officiella tilläggen för typografi och formulär har porterats till PHP och läses in med @plugin. Tillägg som endast finns som JavaScript-paket körs inte, eftersom inget kör Node.

Klassalias är @apply-regler inuti @layer utilities, till exempel en .btn som byggts av padding- och radieverktyg. De kompileras både i frontend och i redigerarens förhandsvisning.

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 fält

Ge ett classes-fält "tailwind": true så får redigerare automatisk komplettering från den fullständiga klasslistan, medan en medföljande Tailwind-webbläsarversion förhandsvisar varje ändring på arbetsytan.

Med assets.reset.enabled återställer arbetsytan även visnings- och positioneringsverktyg som flex, grid och sticky, vilka annars skulle åsidosättas av omslagsregler för redigeraren.

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

En formatmall, cachelagrad efter klassuppsättning

Kompilerad CSS cachelagras på disk under en nyckel som byggs av sidans sorterade klasskandidater och indata från CSS, så nonces och tidsstämplar gör aldrig att cachen ogiltigförklaras och sidor med samma klasser delar en fil.

Inline-utdata är standard. "output": "link" skickar i stället cachefilen som en innehållshashad formatmall. Vid mätning av en lokal kopia av webbplatsen den 8 oktober 2026 minskade startsidans storlek från 451,648 till 296,379 byte, med HTML.

När cache.path pekar på en privat volym använder Blockstudio infogad CSS som reserv, såvida inte filtret blockstudio/files/url returnerar en publik URL för omfattningen tailwind, till exempel en värd för CDN.

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

Slå ihop klasser i PHP

bs_tw_merge() löser konflikter mellan utility-klasser så att en angiven klass vinner över en standardklass. bs_tw_variants() returnerar en variantfunktion med basklasser, varianter, standardvärden och sammansatta varianter.

Båda använder motorn TailwindPHP som Blockstudio redan inkluderar, så ett tema behöver ingen egen kopia.

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

Rensa vid behov

Runtime_Cache::purge(‘tailwind’) rensar den kompilerade CSS, och nästa begäran kompilerar den igen.

Valfri sidbuffert

En webbplats som varken använder Tailwind eller blockresurser kan stänga av sidbufferten med filtret blockstudio/buffer/enabled.

Isolerad per källa

Med en logisk identifieringskälla läggs den valda källan och körningskontexten till i cache-namnrymden, så att den senast fungerande CSS aldrig läcker mellan förhandsvisningar.

Kanonisk lagerordning

Tema, bas, komponenter och sedan verktyg, som i Tailwind CSS, så att senare lager åsidosätter tidigare.

Plus

Det officiella tilläggspaketet

Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.

  • 500+ webbplatsmallar
  • AI-systeminstruktioner
  • Uppdateringar livet ut
  • Privat Discord-community