Liigu sisu juurde

Tailwind v4 ilma Node’ita

Iga leht kompileerib ainult kasutatavad klassid asukohas PHP.

Üks seade, ehitussammuta

Määrake tailwind.enabled asukohas blockstudio.json ja kirjutage utiliidiklasse mis tahes mallis. Iga esikülje päringu ajal kogub Blockstudio valmis HTML klassikandidaadid ja kompileerib neist täpselt need, kasutades TailwindPHP, mis on Tailwind CSS 4.3 PHP port.

Puudub Node.js, CLI ja jälgija. Arvesse lähevad plokimallide, teemamallide, pluginite ja the_content klassid, sest skannitakse kogu leht.

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

Node’i käituskeskkonnata

TailwindPHP kompileerib päringu ajal; midagi pole vaja ehitada ega juurutada.

Tailwind 4.3 utiliidid

Utiliidid, variandid, suvalised väärtused ja direktiivid versioonist Tailwind CSS 4.3.

Kogu lehe skannimine

Arvesse lähevad klassid kõikjal lõplikus HTML-is.

Vahemällu salvestatud klassikomplekti järgi

Samu klasse kasutavad lehed jagavad üht kompileeritud faili.

CSS-keskne seadistus

@theme märgid ja @utility reeglid asukohas blockstudio.json või filtris.

Reaalajas eelvaade redaktoris

Komplektis olev brauseriversioon kuvab klasse kirjutamise ajal eelvaates.

Lingitud väljund

Üks sisuräsi sisaldav laaditabel, mida brauserid ja servavahemälud saavad talletada.

Tüpograafia ja vormid

Kaks ametlikku pluginat on porditud PHP-i ja laaditakse koos @plugin-iga.

Seadistatud asukohas CSS

Tailwind v4 seadistatakse CSS abil, mitte failiga JavaScript. Lisage @theme märgid, @utility reeglid ja kihid faili tailwind.config või lisage need filtri blockstudio/tailwind/css kaudu, kui need koosnevad mitmest reast.

Ametlikud tüpograafia- ja vormipluginad on porditud PHP-i ja laaditakse koos @plugin-ga. Pluginad, mis on saadaval ainult pakettidena JavaScript, ei tööta, sest Node’i koodi ei käivitata.

Klassialias on @layer utilities sees olev @apply reegel, näiteks .btn, mis on loodud polsterduse ja raadiuse utiliitidest. Need kompileeritakse nii esiküljele kui ka redaktori eelvaatesse.

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

Klassid väljana

Määrake classes väljale väärtus "tailwind": true ja redaktorid saavad täieliku klassiloendi põhjal automaattäite; komplektis olev Tailwind brauseriversioon kuvab iga muudatuse eelvaate lõuendil.

Kui assets.reset.enabled on kasutusel, taastab lõuend ka kuvamise ja positsiooni utiliidid, näiteks flex, grid ja sticky, mille redaktori ümbrise reeglid muidu üle kirjutaksid.

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

Üks laaditabel, vahemällu salvestatud klassikomplekti järgi

Kompileeritud CSS salvestatakse kettale vahemällu võtmega, mis moodustatakse lehe sorditud klassikandidaatidest ja sisendist CSS, nii et nonce’id ja ajatemplid ei tühista seda ning sama klassistikuga lehed jagavad üht faili.

Vaikimisi väljastatakse stiil inline-vormis. "output": "link" väljastab selle vahemälufaili hoopis sisuräsi sisaldava stiililehena. Selle saidi kohalikul koopial tehtud mõõtmise järgi kulus avalehel 2026 HTML baiti: 451,648 asemel 296,379.

Kui cache.path osutab privaatsele köitele, kasutab Blockstudio vaikimisi tekstisisest CSS-i, välja arvatud juhul, kui filter blockstudio/files/url tagastab ulatuse tailwind jaoks avaliku URL-i, näiteks CDN-i hosti.

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

Ühenda klassid rakenduses PHP

bs_tw_merge() lahendab vastuolulised utiliidid nii, et autori määratud klass jääb vaikeväärtuse suhtes peale. bs_tw_variants() tagastab variandi, mida saab kutsuda baasklasside, variantide, vaikeväärtuste ja liitvariantidega.

Mõlemad kasutavad mootorit TailwindPHP, mille Blockstudio juba komplekti lisab, nii et teemal pole vaja enda koopiat.

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

Tühjendamine nõudmisel

Runtime_Cache::purge(‘tailwind’) kustutab kompileeritud CSS-i ja järgmise päringu korral kompileeritakse see uuesti.

Valikuline lehepuhver

Sait, mis ei kasuta ei Tailwind-i ega plokivarasid, saab lehepuhvri välja lülitada filtriga blockstudio/buffer/enabled.

Allikapõhine eraldatus

Loogilise avastamisallika korral lisatakse vahemälu nimeruumi valitud allikas ja käituskontekst, nii et viimase õnnestunud CSS ei leki eelvaadete vahel.

Kanooniline kihtide järjekord

Teema, alus, komponendid ja seejärel utiliidid, nagu Tailwind CSS-is, nii et hilisemad kihid kirjutavad varasemad üle.

Plus

Ametlik laienduskomplekt

Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.

  • 500+ saidimalli
  • Tehisintellekti süsteemijuhised
  • Eluaegsed uuendused
  • Privaatne Discord-i kogukond