Ga naar de inhoud

Tailwind v4 zonder Node

Elke pagina compileert alleen de klassen die deze gebruikt, in PHP.

Eén instelling, geen buildstap

Stel tailwind.enabled in blockstudio.json in en schrijf utilityklassen in elk template. Bij elk frontendverzoek verzamelt Blockstudio de klassekandidaten in de voltooide HTML en compileert precies die met TailwindPHP, een PHP-port van Tailwind CSS 4.3.

Er is geen Node.js, geen CLI en geen watcher. Klassen uit blocktemplates, thematemplates, plugins en the_content tellen allemaal mee, omdat de hele pagina wordt gescand.

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

Geen Node-runtime

TailwindPHP compileert tijdens het verzoek; er hoeft niets gebouwd of uitgerold te worden.

Tailwind 4.3-utilities

Utilities, varianten, willekeurige waarden en directives uit Tailwind CSS 4.3.

Scan van de hele pagina

Klassen tellen mee, waar ze ook voorkomen in de uiteindelijke HTML.

Gecachet per klassenset

Pagina’s met dezelfde klassen delen één gecompileerd bestand.

Configuratie met CSS als uitgangspunt

@theme-tokens en @utility-regels in blockstudio.json of een filter.

Livevoorbeeld in de editor

Een meegeleverde browserbuild toont een voorbeeld van klassen terwijl u typt.

Gekoppelde uitvoer

Eén stylesheet met contenthash dat browsers en edgecaches kunnen bewaren.

Typografie en formulieren

De twee officiële plugins zijn geport naar PHP en worden geladen met @plugin.

Geconfigureerd in CSS

Tailwind v4 wordt geconfigureerd met CSS, niet met een JavaScript-bestand. Plaats @theme-tokens, @utility-regels en lagen in tailwind.config, of voeg ze toe via het blockstudio/tailwind/css-filter wanneer ze over meerdere regels lopen.

De officiële plugins voor typografie en formulieren zijn geport naar PHP en worden geladen met @plugin. Plugins die alleen als JavaScript-pakketten bestaan, werken niet, omdat er niets in Node wordt uitgevoerd.

Klassaliassen zijn @apply-regels binnen @layer utilities, zoals een .btn samengesteld uit opvul- en afrondingshulpmiddelen. Ze worden zowel op de frontend als in het editorvoorbeeld gecompileerd.

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

Klassen als veld

Geef een veld van het type classes "tailwind": true en editors krijgen autocomplete uit de volledige klassenlijst, met een meegeleverde Tailwind-browserbuild die elke wijziging in het canvas toont.

Met assets.reset.enabled herstelt het canvas ook display- en positioneringsutilities zoals flex, grid en sticky, die anders zouden worden overschreven door wrapperregels van de editor.

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

Eén stylesheet, gecachet per klassenset

Gecompileerde CSS wordt op schijf gecachet onder een sleutel op basis van de gesorteerde klassekandidaten van de pagina en de invoer CSS, zodat nonces en tijdstempels de cache nooit ongeldig maken en pagina’s met dezelfde klassen één bestand delen.

Inline-uitvoer is de standaard. "output": "link" verstuurt dat cachebestand in plaats daarvan als een stylesheet met een contenthash. Metingen op een lokale kopie van deze site op 8 oktober 2026 lieten zien dat de homepage van 451,648 naar 296,379 bytes ging met HTML.

Wanneer cache.path naar een privévolume verwijst, valt Blockstudio terug op inline CSS, tenzij het filter blockstudio/files/url een openbare URL retourneert voor de tailwind-scope, zoals een CDN-host.

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

Klassen samenvoegen in PHP

bs_tw_merge() lost conflicten tussen utilities op, zodat een zelf opgegeven klasse voorrang krijgt op een standaardklasse. bs_tw_variants() retourneert een variantfunctie met basisklassen, varianten, standaardwaarden en samengestelde varianten.

Beide gebruiken de TailwindPHP-engine die Blockstudio al meelevert, zodat een thema geen eigen kopie nodig heeft.

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

Op aanvraag opschonen

Runtime_Cache::purge(‘tailwind’) wist de gecompileerde CSS, waarna deze bij het volgende verzoek opnieuw wordt gecompileerd.

Optionele paginabuffer

Een site die noch Tailwind noch blokassets gebruikt, kan de paginabuffer uitschakelen met het filter blockstudio/buffer/enabled.

Per bron geïsoleerd

Bij een logische ontdekkingsbron worden de geselecteerde bron en de runtimecontext onderdeel van de cachenamespace, zodat de laatst geslaagde CSS nooit tussen voorbeelden lekt.

Canonieke volgorde van lagen

Thema, basis, componenten en daarna hulpprogramma’s, zoals in Tailwind CSS, zodat latere lagen eerdere overschrijven.

Plus

De officiële uitbreidingskit

Premium-sitetemplates, AI-systeeminstructies en een privécommunity van Discord. Eenmalige aankoop, levenslange updates.

  • 500+ websitesjablonen
  • Systeeminstructies voor AI
  • Updates voor altijd
  • Privécommunity van Discord