Dennis · 19 de mayo de 2026
Blockstudio 7.3
Blockstudio 7.3 añade una nueva capa al framework: componentes reutilizables de UI que pueden mostrarse como cualquier otro bloque.
Mientras que la versión 7.1 convirtió los bloques en aplicaciones de pila completa y la 7.2 facilitó inspeccionar, validar y distribuir proyectos grandes, la 7.3 se centra en la experiencia diaria de crear y editar esas aplicaciones.
En resumen:
- Componentes UI: una biblioteca de componentes de
bsui/*incluida y opcional, impulsada por la WordPress de Interactividad de API. - Aplicaciones: ejemplos de
app/*incluidos que muestran cómo se combinan los componentes de UI para crear interfaces más amplias. - Editor ampliado: un cajón más ancho para editar campos de Blockstudio cuando la barra lateral queda demasiado estrecha.
- Selectores de recursos con ámbito: los recursos de CSS y SCSS pueden usar
%selector%para seleccionar directamente la clase contenedora del bloque. - Dependencias de plugins: los bloques pueden requerir plugins WordPress activos, con restricciones de versión opcionales.
- Políticas del editor:
blockstudio.jsonpuede configurar bloques globales, patrones y comportamiento de medios mediante hooks del editor basados en WordPress PHP. - Alias de etiquetas de bloques: alias personalizados para crear etiquetas de bloques.
- Análisis estático y documentación: mejor cobertura de PHPStan para bibliotecas externas de bloques, además de documentación generada para ajustes y hooks.
- Correcciones de páginas y del editor: análisis más fiable de páginas basadas en archivos, detección de candidatos de Tailwind, modo de restablecimiento, aislamiento de la caché de renderizado y precargas del editor.
Biblioteca de UI
La versión 7.3 incluye una biblioteca de componentes y aplicaciones de ejemplo creadas con ella.
Componentes de UI
Blockstudio 7.3 incluye una biblioteca de UI dentro del espacio de nombres bsui/*. Los componentes son bloques normales de Blockstudio, por lo que se pueden mostrar en plantillas, páginas basadas en archivos, patrones y contenido de entradas con la misma sintaxis de etiquetas de bloques que ya usas.
La biblioteca de componentes de UI está en fase beta mientras recopilamos más comentarios. El objetivo de la versión 7.3 es ofrecer el primer conjunto de componentes, aprender de proyectos reales y perfeccionar los nombres, el comportamiento y los valores predeterminados antes de considerar estable la interfaz de API.
La biblioteca es opcional:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Una vez activada, los componentes sencillos se pueden mostrar directamente:
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
También funciona la sintaxis abreviada de bs::
<bs:bsui-button label="Save" variant="default" />
El objetivo no es convertir Blockstudio en un kit de UI para crear páginas. Se trata de ofrecer primitivas de interfaz comunes como bloques, para que las aplicaciones creadas con Blockstudio no tengan que recrear botones, diálogos, pestañas, selectores, campos de formulario, menús, barras de herramientas y componentes de comentarios en cada proyecto.
El primer conjunto de componentes incluye primitivas de diseño, acciones, entradas, superposiciones, navegación, comentarios, formularios y visualización de datos:
bsui/button,bsui/button-group,bsui/toggle,bsui/toggle-group,bsui/toolbarbsui/input,bsui/textarea,bsui/select,bsui/checkbox,bsui/radio-group,bsui/slider,bsui/switch,bsui/number-field,bsui/password-input,bsui/phone-input,bsui/otp-input,bsui/date-input,bsui/time-pickerbsui/dialog,bsui/drawer,bsui/popover,bsui/menu,bsui/context-menu,bsui/menubar,bsui/tooltip,bsui/alert-dialogbsui/tabs,bsui/accordion,bsui/breadcrumb,bsui/pagination,bsui/navigation-menubsui/card,bsui/table,bsui/stack,bsui/separator,bsui/aspect-ratio,bsui/badge,bsui/avatar,bsui/progress,bsui/meter,bsui/skeleton,bsui/spinner,bsui/kbdbsui/form,bsui/field,bsui/field-group,bsui/file-upload,bsui/color-picker,bsui/rating
Muchos de estos son bloques compuestos. Un bloque bsui/tabs gestiona el estado interactivo, mientras que los bloques secundarios, como bsui/tabs-list, bsui/tabs-trigger y bsui/tabs-panel, describen la estructura.
<block name="bsui/tabs" defaultValue="features">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="features" title="Features"></block>
<block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
</block>
<block name="bsui/tabs-panel" value="features">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="pricing">
<p>Pricing content.</p>
</block>
</block>
Así, el marcado se mantiene legible y la API de Interactividad se ocupa del estado y del comportamiento.
Ejemplos de aplicaciones
El espacio de nombres app/* contiene ejemplos creados con los mismos componentes de UI.
No son un framework aparte, sino implementaciones de referencia para interfaces más amplias de Blockstudio: bloques compuestos, UI anidados, estado de la API de Interactividad y casos en los que los componentes de UI se combinan con funciones de RPC o de bases de datos.
<block name="app/kitchen-sink"></block>
<block name="app/chat">
<block name="app/chat-sidebar"></block>
<block name="app/chat-header"></block>
<block name="app/chat-messages"></block>
<block name="app/chat-input"></block>
</block>
La biblioteca de UI también incluye su propia documentación y una referencia interactiva de componentes. El comportamiento de los componentes no es solo una colección de plantillas. Forma parte del contrato del framework y mantiene su coherencia a medida que crece la biblioteca.
Creación y edición
Varios cambios facilitan la creación y edición de bloques.
Editor ampliado
Editar bloques complejos en la barra lateral del inspector puede volverse difícil enseguida. Esto ocurre sobre todo con repetidores, campos de código, texto enriquecido y grupos anidados.
Blockstudio 7.3 añade una acción para ampliar el editor en el inspector de bloques. Abre un cajón más ancho desde el lado derecho del editor y muestra allí los mismos campos de Blockstudio.
Lo importante es que sigue siendo el mismo sistema de campos. No duplica la representación de los campos ni introduce una segunda vía de persistencia. Los cambios que haces en el editor ampliado actualizan el bloque seleccionado igual que los cambios realizados en la barra lateral habitual.
Úsalo cuando la barra lateral sea práctica para revisar, pero demasiado estrecha para introducir datos.
Selectores de recursos con ámbito
Blockstudio ya admitía %selector% en los campos de código. En la versión 7.3, los recursos CSS y SCSS de los bloques pueden usar el mismo patrón de creación.
En un archivo CSS, %selector% se sustituye por la clase con ámbito del bloque:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Así se puede aplicar estilo al elemento contenedor real:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Los selectores normales de *.scoped.css siguen seleccionando los elementos descendientes. %selector% es el hook explícito para la raíz del bloque.
Dependencias de plugins
Ahora los bloques pueden declarar dependencias de plugins WordPress en la clave blockstudio de block.json.
La forma sencilla comprueba que todos los slugs de plugins enumerados estén activos:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
La forma de objeto añade restricciones de versión:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Los identificadores son slugs de plugins de WordPress, que coinciden con el sistema de dependencias de plugins del núcleo de WordPress. Blockstudio resuelve los plugins activos a esos slugs y omite el registro si falta un plugin obligatorio, está inactivo o tiene una versión inferior a la requerida.
La restricción de versión usa el mismo modelo de comparación que PHP version_compare(). Una versión simple como "6" se interpreta como >=6.
Esto resulta útil para bloques que solo tienen sentido cuando hay un plugin disponible: tarjetas de producto de WooCommerce, integraciones de formularios, integraciones de SEO, componentes de membresía, widgets de reservas o UI de administración vinculados a un plugin de terceros.
Políticas del editor
El archivo blockstudio.json también está adquiriendo más utilidad como archivo de políticas del editor a nivel de proyecto.
La versión 7.3 añade una capa de políticas de blockEditor basada en PHP para los ajustes que WordPress ya expone mediante hooks del lado del servidor. Así puedes definir el comportamiento global del insertador, los patrones y los medios sin distribuir código puntual de integración en el tema.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
}
},
"patterns": {
"core": false,
"remote": false,
"categories": {
"deny": ["gallery"],
"order": ["featured", "buttons"]
}
},
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"]
}
}
}
}
La primera fase se limita intencionadamente a opciones respaldadas por PHP: bloques permitidos y bloqueados, carga del directorio de bloques, etiquetas y orden de las categorías del insertador, fuentes y categorías de patrones, Openverse, opciones de tamaño de imagen, visibilidad de los widgets heredados y eliminación de estilos de bloque registrados mediante PHP.
No pretende reescribir los valores predeterminados de bloques arbitrarios del núcleo. Ajustes como core/columns.isStackedOnMobile forman parte del flujo de registro JavaScript del editor de bloques, por lo que requieren una API aparte y más explícita, en lugar de incluirse a la fuerza en un archivo JSON.
Alias de etiquetas de bloques
Ahora las etiquetas de bloques tienen un filtro de alias:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Esto permite que un proyecto defina etiquetas fáciles de usar al crear contenido y, al mismo tiempo, las resuelva internamente al nombre canónico del bloque.
<bs:theme-button label="Continue" />
Esto resulta especialmente útil al componer plantillas con mucho UI, donde los nombres canónicos de los bloques son correctos, pero no siempre son los más cómodos para crear contenido.
Herramientas y fiabilidad
Se avanzó en el análisis estático, la fiabilidad y las herramientas de rendimiento.
Análisis estático y documentación generada
La extensión de PHPStan ahora admite raíces de análisis explícitas para bibliotecas de bloques externas. Así, un proyecto puede validar etiquetas <bs:*> y <block> con bloques que están fuera del plugin o tema actual, y mantener esas raíces solo en el registro para el análisis.
También se ampliaron las comprobaciones de esquemas para abarcar los metadatos de página y pluginDependencies, lo que facilita detectar configuraciones no válidas en el momento de la publicación antes de que lleguen a WordPress.
La generación de documentación ahora incluye referencias a los filtros de los ajustes y a los hooks de PHP. Esto cobra más importancia a medida que blockstudio.json se convierte en un verdadero archivo de políticas del proyecto, en lugar de ser solo un conjunto de opciones dispersas.
Fiabilidad de páginas y del editor
La versión 7.3 también incluye varias correcciones para páginas basadas en archivos, el renderizado del editor y el modo de restablecimiento.
El análisis de páginas basado en archivos ahora admite asignaciones de contenedores personalizados que tienen en cuenta los atributos durante el análisis de HTML. Las etiquetas de página de bs: también resuelven correctamente los espacios de nombres de bloques con guiones, por lo que nombres como custom-theme/card ya no confunden al analizador.
Las etiquetas genéricas de contenedor que no son del núcleo ahora serializan innerContent válido cuando no proporcionan marcado de envoltura. Así, el contenido de página sincronizado es más predecible y la serialización de bloques de WordPress sigue siendo válida.
El editor recibió varias correcciones relacionadas con las vistas previas y el comportamiento de precarga:
- Tailwind editor CSS ahora incluye candidatos de clases de las plantillas de página basadas en archivos.
- Las precargas del editor conservan las clases envolventes de RichText para bloques repetidos del mismo tipo.
- Las precargas del editor coinciden con bloques cuyos valores de campo predeterminados se amplían mediante Gutenberg, pero se omiten del marcado guardado del bloque.
- Los atributos predeterminados registrados que se amplían mediante Gutenberg se ignoran antes de comparar las claves de la caché de renderizado.
- Las representaciones de vista previa del editor y del insertador ahora mantienen entradas de caché separadas, aunque compartan un id de cliente.
bs_get_group()ahora funciona correctamente con grupos de campos personalizados reutilizados, incluidos los grupos cuyo id coincide con el nombre del campo personalizado, y solo extrae prefijos exactos de grupo.- Los campos de enlace con
withCreateSuggestionahora conectan correctamente el flujo de creación de WordPress LinkControl y crean páginas en borrador mediante REST API. - Las plantillas de bloque PHP ahora se ejecutan una vez por representación, en lugar de ejecutar una inclusión previa descartada.
También se ajustó el modo de restablecimiento. Ahora neutraliza las reglas de ancho y margen vertical de los bloques del editor Gutenberg para los tipos de contenido configurados, elimina los estilos de contenido/restablecimiento del iframe de WordPress cuando es necesario y ofrece superposiciones de selección y al pasar el cursor más limpias en Blockstudio.
También se amplió la cobertura de regresiones para patrones complejos de InnerBlocks con bloques anidados de Blockstudio, de modo que la ruta de renderizado del editor se comprueba con los casos de inserción de patrones más difíciles de detectar manualmente.
Herramientas de rendimiento
Las sondas locales y anónimas de blockstudio-perf=1 ahora pueden emitir encabezados Server-Timing sin inyectar el panel de depuración.
Los tiempos también abarcan más fases del ciclo de compilación: detección, procesamiento de recursos, registro y anulaciones. Así es más fácil ver en qué se va el tiempo sin activar una UI de perfilado visible.
Por qué importa esta versión
El tema central de la versión 7.3 es la composición.
Los componentes UI facilitan la composición de interfaces de aplicaciones. Editor ampliado facilita la edición de bloques más grandes. Las dependencias de plugins permiten que los bloques describan el contexto de plugin que necesitan. Las políticas del editor trasladan las reglas del editor de bloques del proyecto a blockstudio.json. Los alias de etiquetas de bloques simplifican la creación de plantillas. Las correcciones del analizador, PHPStan y del editor hacen que esas composiciones sean más fiables cuando pasan por WordPress.
Blockstudio sigue basándose en archivos. Los bloques siguen siendo carpetas. Las plantillas siguen haciendo el trabajo. Pero ahora el framework cuenta con una capa UI más sólida sobre esa base.