# Tailwind v4 sem Node

Cada página compila apenas as classes que usa, em PHP.

## Uma configuração, sem etapa de compilação

Defina `tailwind.enabled` em `blockstudio.json` e escreva classes utilitárias em qualquer modelo. A cada solicitação do frontend, Blockstudio coleta os candidatos a classe no HTML finalizado e compila exatamente esses com TailwindPHP, uma implementação em PHP da versão 4.3 de Tailwind CSS.

Não há Node.js, CLI nem observador. Classes de modelos de blocos, modelos do tema, plugins e `the_content` também são consideradas, pois a página inteira é analisada.

[Ativando Tailwind](https://blockstudio.dev/pt/docs/tailwind/#enabling-tailwind)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true
  }
}
```

## Sem ambiente de execução Node

TailwindPHP compila durante a solicitação; não há nada para compilar ou implantar.

## Utilitários de Tailwind 4.3

Utilitários, variantes, valores arbitrários e diretivas de Tailwind CSS 4.3.

## Análise da página inteira

As classes são consideradas onde quer que apareçam no HTML final.

## Armazenado em cache por conjunto de classes

Páginas que usam as mesmas classes compartilham um arquivo compilado.

## Configuração com CSS em primeiro lugar

Tokens @theme e regras @utility em blockstudio.json ou em um filtro.

## Pré-visualização ao vivo no editor

Uma versão integrada para navegador pré-visualiza as classes enquanto você digita.

## Saída vinculada

Uma folha de estilos com hash de conteúdo que os navegadores e caches de borda podem manter.

## Tipografia e formulários

Os dois plugins oficiais foram portados para PHP e são carregados com @plugin.

## Configurado em CSS

Tailwind v4 é configurado com CSS, não com um arquivo JavaScript. Adicione tokens `@theme`, regras `@utility` e camadas em `tailwind.config` ou acrescente-os pelo filtro `blockstudio/tailwind/css` quando estiverem distribuídos por várias linhas.

Os plugins oficiais de tipografia e formulários foram portados para PHP e carregados com `@plugin`. Plugins que só existem como pacotes JavaScript não são executados, pois nada executa Node.

Os aliases de classe são regras `@apply` dentro de `@layer utilities`, como um `.btn` criado com utilitários de preenchimento e raio. Eles são compilados tanto no frontend quanto na pré-visualização do editor.

[Configuração](https://blockstudio.dev/pt/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;
    }
  ';
});
```

## Classes como campo

Defina um campo `classes` como `"tailwind": true` e os editores terão preenchimento automático com a lista completa de classes, além de uma pré-visualização integrada no navegador de Tailwind para cada alteração na tela de edição.

Com `assets.reset.enabled`, a tela de edição também restaura utilitários de exibição e posicionamento, como `flex`, `grid` e `sticky`, que de outra forma seriam substituídos pelas regras do contêiner do editor.

[Tipo de campo Classes](https://blockstudio.dev/pt/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"
      }
    ]
  }
}
```

## Uma folha de estilos, armazenada em cache por conjunto de classes

O CSS compilado é armazenado em cache no disco com uma chave criada a partir dos candidatos a classe da página, ordenados, e da entrada CSS; assim, nonces e marcas de tempo nunca invalidam o cache, e páginas com as mesmas classes compartilham um arquivo.

A saída em linha é o padrão. `"output": "link"` emite esse arquivo de cache como uma folha de estilos com hash de conteúdo. Em uma medição feita em uma cópia local deste site em 8 de outubro, 2026, o tamanho da página inicial passou de 451,648 para 296,379 bytes com HTML.

Quando `cache.path` aponta para um volume privado, Blockstudio usa CSS inline como alternativa, a menos que o filtro `blockstudio/files/url` retorne um URL público para o escopo `tailwind`, como um host CDN.

[Saída do frontend](https://blockstudio.dev/pt/docs/tailwind/#frontend-output)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}
```

## Combine classes em PHP

`bs_tw_merge()` resolve conflitos entre utilitários para que uma classe criada pelo autor prevaleça sobre um padrão. `bs_tw_variants()` retorna uma função de variante com classes base, variantes, padrões e variantes compostas.

Ambos usam o mecanismo TailwindPHP que Blockstudio já inclui, então um tema não precisa de sua própria cópia.

[Auxiliares de modelo](https://blockstudio.dev/pt/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']);
```

## Limpeza sob demanda

Runtime_Cache::purge(‘tailwind’) limpa o CSS compilado, e a próxima solicitação o compila novamente.

## Buffer de página opcional

Um site que não usa Tailwind nem recursos de blocos pode desativar o buffer de página com o filtro blockstudio/buffer/enabled.

## Isolado por origem

Com uma origem lógica de descoberta, a origem selecionada e o contexto de execução passam a fazer parte do namespace do cache, evitando que o último CSS válido vaze entre pré-visualizações.

## Ordem canônica das camadas

Tema, base, componentes e, por fim, utilitários, como em Tailwind CSS, para que as camadas posteriores sobrescrevam as anteriores.

Plus

## O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord

[Obter Plus](https://blockstudio.dev/pt/plus/)
