# 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.

[Tailwind-ominaisuuden käyttöönotto](https://blockstudio.dev/fi/docs/tailwind/#enabling-tailwind)

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.

[Määritykset](https://blockstudio.dev/fi/docs/tailwind/#configuration)

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.

[Luokat-kentän tyyppi](https://blockstudio.dev/fi/docs/tailwind/#classes-field-type)

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.

[Käyttöliittymän tuloste](https://blockstudio.dev/fi/docs/tailwind/#frontend-output)

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.

[Mallipohjien apufunktiot](https://blockstudio.dev/fi/docs/tailwind/#template-composition-helpers)

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ö

[Hanki Plus](https://blockstudio.dev/fi/plus/)
