Saltar al contenido

Tailwind v4 sin Node

Cada página compila solo las clases que utiliza, en PHP.

Un ajuste, sin pasos de compilación

Establece tailwind.enabled en blockstudio.json y escribe clases de utilidad en cualquier plantilla. En cada solicitud del frontend, Blockstudio recopila las clases candidatas del HTML terminado y compila exactamente esas clases con TailwindPHP, un port de Tailwind CSS 4.3 incluido en PHP.

No hay Node.js, CLI ni un observador. También se cuentan las clases de las plantillas de bloques, del tema, de los plugins y de the_content, porque se analiza la página completa.

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

Sin entorno de ejecución de Node

TailwindPHP compila durante la solicitud; no hay nada que compilar ni desplegar.

Utilidades de Tailwind 4.3

Utilidades, variantes, valores arbitrarios y directivas de Tailwind CSS 4.3.

Análisis de toda la página

Las clases se cuentan dondequiera que aparezcan en el HTML final.

Caché por conjunto de clases

Las páginas que usan las mismas clases comparten un archivo compilado.

Configuración centrada en CSS

Tokens de @theme y reglas de @utility en blockstudio.json o en un filtro.

Vista previa en vivo en el editor

Una compilación para navegador incluida en el paquete muestra una vista previa de las clases mientras escribes.

Salida enlazada

Una hoja de estilos con hash de contenido que los navegadores y las cachés de borde pueden conservar.

Tipografía y formularios

Los dos plugins oficiales se han adaptado a PHP y se cargan con @plugin.

Configurado en CSS

Tailwind v4 se configura con CSS, no con un archivo JavaScript. Añade tokens de @theme, reglas de @utility y capas en tailwind.config, o incorpóralos mediante el filtro blockstudio/tailwind/css si ocupan varias líneas.

Los plugins oficiales de tipografía y formularios se han adaptado a PHP y se cargan con @plugin. Los plugins que solo existen como paquetes JavaScript no se ejecutan, porque aquí no se ejecuta Node.

Los alias de clase son reglas @apply dentro de @layer utilities, como un .btn creado a partir de utilidades de relleno y radio. Se compilan tanto en el frontend como en la vista previa del editor.

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

Las clases como campo

Asigna "tailwind": true a un campo classes para que los editores obtengan autocompletado con la lista completa de clases; incluye una vista previa de cada cambio en el lienzo mediante una compilación Tailwind para navegador.

Con assets.reset.enabled, el lienzo también recupera utilidades de visualización y posición como flex, grid y sticky, que de otro modo quedarían anuladas por las reglas del contenedor del editor.

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

Una hoja de estilos, almacenada en caché por conjunto de clases

El CSS compilado se guarda en disco con una clave basada en las clases candidatas ordenadas de la página y la entrada CSS, por lo que los nonces y las marcas de tiempo no invalidan la caché y las páginas con las mismas clases comparten un archivo.

La salida integrada es la opción predeterminada. "output": "link" emite ese archivo de caché como una hoja de estilos con hash de contenido. En una medición realizada el 8 de octubre en una copia local de este sitio, 2026, la página principal pasó de 451,648 a 296,379 bytes con HTML.

Cuando cache.path apunta a un volumen privado, Blockstudio recurre a CSS integrado, a menos que el filtro blockstudio/files/url devuelva un URL público para el ámbito tailwind, como un host CDN.

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

Combinar clases en PHP

bs_tw_merge() resuelve los conflictos entre utilidades para que una clase escrita explícitamente prevalezca sobre una predeterminada. bs_tw_variants() devuelve una función de variantes que acepta clases base, variantes, valores predeterminados y variantes compuestas.

Ambos usan el motor TailwindPHP que Blockstudio ya incluye, así que el tema no necesita una copia propia.

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

Purgar a petición

Runtime_Cache::purge(‘tailwind’) borra el CSS compilado y la siguiente solicitud lo vuelve a compilar.

Búfer de página opcional

Un sitio que no use Tailwind ni recursos de bloques puede desactivar el búfer de página con el filtro blockstudio/buffer/enabled.

Aislado por origen

Con un origen de detección lógico, el origen seleccionado y el contexto de ejecución se incorporan al espacio de nombres de la caché, por lo que el último CSS válido nunca se filtra entre vistas previas.

Orden canónico de capas

Tema, base, componentes y, después, utilidades, como en Tailwind CSS, para que las capas posteriores prevalezcan sobre las anteriores.

Plus

El kit oficial de extensiones

Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.

  • Más de 500 plantillas de sitios web
  • Instrucciones del sistema de IA
  • Actualizaciones de por vida
  • Comunidad privada de Discord