Siirry sisältöön

Tailwind v4 ilman Nodea

Jokainen sivu kokoaa vain käyttämänsä luokat hakemistoon PHP.

Yksi asetus, ei koontivaihetta

Määritä tailwind.enabled tiedostossa blockstudio.json ja kirjoita apuluokkia mihin tahansa mallipohjaan. Jokaisella käyttöliittymäpyynnöllä Blockstudio kerää luokkaehdokkaat valmiista HTML-tiedostosta ja kokoaa juuri ne käyttäen TailwindPHP-työkalua, joka on Tailwind CSS 4.3:n PHP-toteutus.

Ei ole Node.js-vaihetta, CLI-tiedostoa eikä tarkkailijaa. Lohkomallien, teemamallien, lisäosien ja the_content-tiedostojen luokat lasketaan mukaan, koska koko sivu käydään läpi.

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

Ei Node.js-ympäristöä

TailwindPHP kokoaa pyynnön aikana, joten mitään ei tarvitse koota eikä ottaa käyttöön.

Tailwind 4.3:n apuluokat

Tailwind CSS 4.3:n apuluokat, variantit, mielivaltaiset arvot ja direktiivit.

Koko sivun läpikäynti

Luokat lasketaan mukaan kaikkialta, missä ne esiintyvät lopullisessa HTML-tiedostossa.

Välimuistissa luokkajoukon mukaan

Samat luokat sisältävät sivut jakavat yhden kootun tiedoston.

CSS-lähtöinen määritys

@theme-tunnisteet ja @utility-säännöt tiedostossa blockstudio.json tai suodattimessa.

Live-esikatselu editorissa

Mukana toimitettava selainversio näyttää luokat kirjoittamisen aikana.

Linkitetty tuloste

Yksi sisällön hajautusarvon sisältävä tyylitiedosto, jonka selaimet ja reunavälimuistit voivat säilyttää.

Typografia ja lomakkeet

Kaksi virallista lisäosaa on siirretty PHP-versioon, ja ne ladataan @plugin-määrityksellä.

Määritetty tiedostossa CSS

Tailwind v4 määritetään CSS-tiedostossa, ei JavaScript-tiedostossa. Lisää @theme-tunnisteet, @utility-säännöt ja kerrokset tiedostoon tailwind.config tai lisää ne blockstudio/tailwind/css-suodattimen kautta, kun niitä on usealla rivillä.

Viralliset typografia- ja lomakelisäosat on siirretty PHP-versioon, ja ne latautuvat @plugin-määrityksellä. Pelkkinä JavaScript-paketteina saatavilla olevat lisäosat eivät toimi, koska Node.js-koodia ei suoriteta.

Luokka-aliasit ovat @apply-sääntöjä @layer utilities-sisällä, kuten .btn, joka koostuu sisennys- ja kulmasädeapuohjelmista. Ne käännetään sekä käyttöliittymässä että editorin esikatselussa.

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

Luokat kenttänä

Anna classes-kentälle tyyppi "tailwind": true, niin editorit saavat automaattisen täydennyksen koko luokkaluettelosta. Mukana toimitettava Tailwind-selainversio näyttää kankaan jokaisen muutoksen.

Kun assets.reset.enabled on käytössä, kangas palauttaa myös näyttö- ja sijaintiapuluokat, kuten flex, grid ja sticky, jotka editorin säilön säännöt muuten ohittaisivat.

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

Yksi tyylitiedosto, välimuistissa luokkajoukon mukaan

Käännetty CSS tallennetaan levylle avaimella, joka muodostetaan sivun järjestetyistä luokkaehdokkaista ja CSS-syötteestä. Näin nonce-tunnisteet ja aikaleimat eivät tyhjennä välimuistia, ja samoja luokkia käyttävät sivut jakavat saman tiedoston.

Oletuksena tuloste lisätään sivulle suoraan. "output": "link" tuottaa sen sijaan välimuistitiedostosta sisällön hajautusarvon sisältävän tyylitiedoston. Paikallisesta kopiosta sivustoa 8. lokakuuta 2026 mitattuna etusivun HTML-koko pieneni 451,648 tavusta 296,379 tavuun.

Kun cache.path osoittaa yksityiseen tallennustilaan, Blockstudio käyttää varalla upotettua CSS-sisältöä, ellei blockstudio/files/url-suodatin palauta julkista URL-osoitetta tailwind-laajuudelle, kuten CDN-isännälle.

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

Yhdistä luokat työkalulla PHP

bs_tw_merge() ratkaisee ristiriitaiset apuluokat niin, että itse kirjoitettu luokka voittaa oletusarvon. bs_tw_variants() palauttaa varianttifunktion, jolle voi antaa perusluokat, variantit, oletusarvot ja yhdistelmävariantit.

Molemmat käyttävät TailwindPHP-moottoria, jonka Blockstudio sisältää jo, joten teemaan ei tarvitse sisällyttää omaa kopiota.

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

Tyhjennä tarvittaessa

Runtime_Cache::purge(‘tailwind’) tyhjentää käännetyn CSS-sisällön, ja seuraava pyyntö kääntää sen uudelleen.

Valinnainen sivupuskuri

Sivustolla, joka ei käytä Tailwind-toimintoa eikä lohkoresursseja, sivupuskurin voi poistaa käytöstä blockstudio/buffer/enabled-suodattimella.

Eristetty lähdekohtaisesti

Loogisen löytölähteen yhteydessä valittu lähde ja ajonaikainen konteksti liitetään välimuistin nimiavaruuteen, joten viimeisin kelvollinen CSS ei vuoda esikatselusta toiseen.

Kanoninen kerrosjärjestys

Teema, pohja, komponentit ja sitten apuluokat, kuten Tailwind CSS-määrityksessä, joten myöhemmät kerrokset ohittavat aiemmat.

Plus

Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

  • 500+ sivustomallia
  • Tekoälyn järjestelmäohjeet
  • Elinikäiset päivitykset
  • Yksityinen Discord-yhteisö