Pereiti prie turinio

Tailwind v4 be Node

Kiekvienam puslapiui kompiliuojamos tik jame naudojamos klasės, PHP.

Vienas nustatymas, nereikia kurti

Nustatykite tailwind.enabled faile blockstudio.json ir rašykite pagalbines klases bet kuriame šablone. Kiekvienos frontend užklausos metu Blockstudio surenka klasių kandidatus iš galutinio HTML ir su TailwindPHP, Tailwind CSS 4.3 versijos PHP prievadu, sukompiliuoja tik juos.

Nereikia Node.js, CLI ar stebėjimo priemonės. Skaičiuojamos klasės iš blokų šablonų, temos šablonų, įskiepių ir the_content, nes nuskaitomas visas puslapis.

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

Nereikia Node vykdymo aplinkos

TailwindPHP kompiliuojamas apdorojant užklausą; nieko nereikia kurti ar diegti.

Tailwind 4.3 pagalbinės klasės

Tailwind CSS 4.3 pagalbinės klasės, variantai, savavališkos reikšmės ir direktyvos.

Viso puslapio nuskaitymas

Skaičiuojamos klasės, kad ir kur jos būtų galutiniame HTML.

Podėlis pagal klasių rinkinį

Puslapiai, kuriuose naudojamos tos pačios klasės, dalijasi vienu sukompiliuotu failu.

Konfigūracija, kurioje pirmiausia naudojamas CSS

@theme žetonai ir @utility taisyklės faile blockstudio.json arba filtre.

Tiesioginė rengyklės peržiūra

Pateikta naršyklės versija peržiūri klases jums rašant.

Nuoroda į išvesties failą

Vienas turinio maiša pažymėtas stilių failas, kurį gali saugoti naršyklės ir kraštiniai podėliai.

Tipografija ir formos

Dviejų oficialių įskiepių versijos perkeltos į PHP ir įkeliamos naudojant @plugin.

Konfigūruojama faile CSS

Tailwind v4 konfigūruojama naudojant CSS, o ne JavaScript failą. tailwind.config įrašykite @theme žetonus, @utility taisykles ir sluoksnius arba pridėkite juos per blockstudio/tailwind/css filtrą, jei jie užima kelias eilutes.

Oficialių tipografijos ir formų įskiepių versijos perkeltos į PHP ir įkeliamos naudojant @plugin. Įskiepiai, pasiekiami tik kaip JavaScript paketai, neveikia, nes Node nevykdomas.

Klasių pseudonimai – tai @apply taisyklės, esančios @layer utilities, pavyzdžiui, .btn, sudarytas iš užpildo ir kampų apvalinimo utilitų. Jie kompiliuojami tiek svetainės pusėje, tiek redaktoriaus peržiūroje.

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

Klasės kaip laukas

Suteikite classes laukui tipą "tailwind": true, ir redaktoriuose bus siūlomas visas klasių sąrašas; kartu pateikiama Tailwind naršyklės versija, kurioje drobėje peržiūrimas kiekvienas pakeitimas.

Naudojant assets.reset.enabled, drobėje taip pat atkuriamos rodymo ir padėties pagalbinės klasės, pavyzdžiui, flex, grid ir sticky, kurias kitu atveju pakeistų redaktoriaus apvalkalo taisyklės.

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

Vienas stilių failas, podėlyje pagal klasių rinkinį

Sukompiliuotas CSS saugomas diske; jo raktas sudaromas iš surūšiuotų puslapio klasių kandidatų ir CSS įvesties. Todėl nonce ir laiko žymos jo nepanaikina, o puslapiai su tomis pačiomis klasėmis naudoja tą patį failą.

Pagal numatytuosius nustatymus išvestis įterpiama tiesiogiai. "output": "link" vietoj to pateikia tą podėlio failą kaip turinio maiša pažymėtą stilių failą. Spalio 8 d. 2026 atlikus matavimą vietinėje šios svetainės kopijoje, pagrindinio puslapio dydis sumažėjo nuo 451,648 iki 296,379 baitų (HTML).

Kai cache.path nurodo į privačią saugyklą, Blockstudio naudoja tiesioginį CSS, nebent filtras blockstudio/files/url grąžina viešą URL, skirtą tailwind sričiai, pavyzdžiui, CDN prieglobai.

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

Sujunkite klases naudodami PHP

bs_tw_merge() išsprendžia prieštaravimus tarp pagalbinių klasių, kad autoriaus nurodyta klasė turėtų pirmenybę prieš numatytąją. bs_tw_variants() grąžina variantų funkciją, kuriai perduodamos bazinės klasės, variantai, numatytosios reikšmės ir sudėtiniai variantai.

Abu naudoja TailwindPHP variklį, kurį jau apima Blockstudio, todėl temai nereikia atskiros jo kopijos.

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

Išvalykite pagal poreikį

Runtime_Cache::purge(‘tailwind’) išvalo sukompiliuotą CSS, o kitos užklausos metu jis sukompiliuojamas iš naujo.

Pasirenkamas puslapio buferis

Svetainėje, kurioje nenaudojamas nei Tailwind, nei blokų ištekliai, puslapio buferį galima išjungti naudojant blockstudio/buffer/enabled filtrą.

Atskiras kiekvienam šaltiniui

Naudojant loginį aptikimo šaltinį, pasirinktas šaltinis ir vykdymo kontekstas įtraukiami į podėlio vardų sritį, todėl paskutinis sėkmingas CSS niekada nepatenka į kitas peržiūras.

Standartinė sluoksnių tvarka

Tema, pagrindas, komponentai, tada utilitos, kaip nurodyta Tailwind CSS, todėl vėlesni sluoksniai pakeičia ankstesnius.

Plus

Oficialus plėtinių rinkinys

Aukščiausios klasės svetainių šablonai, DI sistemos instrukcijos ir privati Discord bendruomenė. Vienkartinis pirkimas, atnaujinimai visam laikui.

  • 500+ svetainių šablonų
  • AI sistemos instrukcijos
  • Naujiniai visam laikui
  • Privati Discord bendruomenė