Pāriet uz saturu

Tailwind v4 bez Node

Katra lapa kompilē tikai tajā izmantotās klases, izmantojot PHP.

Viens iestatījums, bez būvēšanas soļa

Iestatiet tailwind.enabled failā blockstudio.json un rakstiet utilītklases jebkurā veidnē. Katrā priekšgala pieprasījumā Blockstudio apkopo klašu kandidātus no gatavā HTML un kompilē tikai tos, izmantojot TailwindPHP — Tailwind CSS 4.3 versijas PHP portu.

Nav Node.js, nav CLI un nav novērotāja. Tiek ņemtas vērā klases no bloku veidnēm, tēmas veidnēm, spraudņiem un the_content, jo tiek skenēta visa lapa.

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

Nav Node izpildvides

TailwindPHP tiek kompilēts pieprasījuma laikā; nekas nav jābūvē vai jāizvieto.

Tailwind 4.3 utilītas

Utilītas, varianti, patvaļīgas vērtības un direktīvas no Tailwind CSS 4.3.

Visas lapas skenēšana

Klases tiek ņemtas vērā neatkarīgi no to atrašanās vietas gala HTML.

Kešots pēc klašu kopas

Lapas ar vienādām klasēm izmanto vienu kompilētu failu.

CSS kā galvenais konfigurācijas avots

@theme tokeni un @utility kārtulas failā blockstudio.json vai filtrā.

Redaktora priekšskatījums tiešsaistē

Komplektā iekļautā pārlūka būvējuma versija priekšskata klases rakstīšanas laikā.

Saistītā izvade

Viena stila lapa ar satura jaucējvērtību, ko var saglabāt pārlūkprogrammu un tīkla malas kešatmiņās.

Tipogrāfija un veidlapas

Abi oficiālie spraudņi ir portēti uz PHP un tiek ielādēti ar @plugin.

Konfigurēts failā CSS

Tailwind v4 tiek konfigurēts ar CSS, nevis JavaScript failu. Ievietojiet @theme tokenus, @utility kārtulas un slāņus failā tailwind.config vai pievienojiet tos, izmantojot filtru blockstudio/tailwind/css, ja tie sadalīti vairākās rindās.

Oficiālie tipogrāfijas un veidlapu spraudņi ir portēti uz PHP un tiek ielādēti ar @plugin. Spraudņi, kas pieejami tikai kā JavaScript pakotnes, nedarbojas, jo nekas neizpilda Node.

Klases aizstājvārdi ir @apply noteikumi @layer utilities, piemēram, .btn, kas izveidota no iekšējās atkāpes un stūru noapaļošanas utilītām. Tie tiek kompilēti gan vietnes priekšpusē, gan redaktora priekšskatā.

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

Klases kā lauks

Piešķiriet classes laukam "tailwind": true, un redaktoriem būs pieejama automātiskā pabeigšana ar pilnu klašu sarakstu; komplektā iekļautā Tailwind pārlūka būvējuma versija priekšskatīs katras izmaiņas rezultātu kanvā.

Izmantojot assets.reset.enabled, kanvā tiek atjaunotas arī attēlošanas un pozicionēšanas utilītas, piemēram, flex, grid un sticky, kuras citādi ignorētu redaktora ietverošā elementa kārtulas.

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

Viena stila lapa, kešota pēc klašu kopas

Kompilētais CSS tiek saglabāts diskā zem atslēgas, kas izveidota no lapas sakārtotajiem klašu kandidātiem un ievades CSS, tāpēc nonce un laika zīmogi kešatmiņu neanulē un lapas ar vienādām klasēm izmanto vienu failu.

Pēc noklusējuma izvade ir iekļauta lapā. "output": "link" tās vietā izvada šo kešatmiņas failu kā satura jaucējvērtības stila lapu. Mērot šīs vietnes lokālu kopiju 8. oktobrī, 2026, sākumlapas izmērs samazinājās no 451,648 līdz 296,379 baitiem (no HTML).

Ja cache.path norāda uz privātu sējumu, Blockstudio izmanto iekļautu CSS, ja vien blockstudio/files/url filtrs neatgriež publisku URL tvērumam tailwind, piemēram, resursdatoru CDN.

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

Apvienojiet klases failā PHP

bs_tw_merge() atrisina konfliktus starp utilītām, lai autora pievienotā klase uzvarētu noklusējuma klasi. bs_tw_variants() atgriež variantu izsaucamu funkciju ar pamatklasēm, variantiem, noklusējumiem un kombinētajiem variantiem.

Abas izmanto dzinēju TailwindPHP, ko Blockstudio jau iekļauj, tāpēc tēmai nav vajadzīga sava kopija.

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

Notīriet pēc pieprasījuma

Runtime_Cache::purge(‘tailwind’) notīra kompilēto CSS, un nākamajā pieprasījumā tas tiek kompilēts no jauna.

Izvēles lapu buferis

Vietnē, kurā netiek izmantots ne Tailwind, ne bloku resursi, lapu buferi var izslēgt ar blockstudio/buffer/enabled filtru.

Atsevišķi katram avotam

Ja tiek izmantots loģisks atklāšanas avots, atlasītais avots un izpildlaika konteksts tiek pievienots kešatmiņas nosaukumtelpai, tāpēc pēdējais sekmīgais CSS nekad nenonāk citos priekšskatījumos.

Kanoniskā slāņu secība

Motīvs, pamats, komponenti un pēc tam utilītas, kā noteikts Tailwind CSS, lai vēlākie slāņi aizstātu agrākos.

Plus

Oficiālais paplašinājumu komplekts

Premium vietņu veidnes, AI sistēmas instrukcijas un privāta Discord kopiena. Vienreizējs pirkums, atjauninājumi uz mūžu.

  • 500+ vietņu veidnes
  • AI sistēmas instrukcijas
  • Atjauninājumi visā lietošanas laikā
  • Privāta Discord kopiena