Pular para o conteúdo

Dennis · 19 de maio de 2026

Blockstudio 7.3

Blockstudio 7.3 adiciona uma nova camada ao framework: componentes UI reutilizáveis que podem ser renderizados como qualquer outro bloco.

Enquanto a versão 7.1 transformou blocos em aplicativos full-stack e a 7.2 facilitou a inspeção, validação e distribuição de projetos maiores, a 7.3 se concentra na experiência diária de criar e editar esses aplicativos.

Em resumo:

  • Componentes UI: uma biblioteca de componentes bsui/* agrupada e opcional, viabilizada pela API de Interatividade WordPress API.
  • Aplicativos: exemplos app/* agrupados que mostram como os componentes UI se combinam em interfaces maiores.
  • Editor ampliado: um painel lateral mais largo para editar campos Blockstudio quando a barra lateral fica apertada demais.
  • Seletores de recursos com escopo: recursos CSS e SCSS podem usar %selector% para direcionar diretamente a classe do contêiner do bloco.
  • Dependências de plugins: os blocos podem exigir plugins WordPress ativos, com restrições de versão opcionais.
  • Políticas do editor: blockstudio.json podem configurar blocos globais, padrões e comportamento de mídia usando hooks do editor baseados em WordPress PHP.
  • Aliases de tags de bloco: aliases personalizados para criar tags de bloco.
  • Análise estática e documentação: melhor cobertura de PHPStan para bibliotecas externas de blocos, além de documentação gerada para configurações e hooks.
  • Correções de páginas e do editor: análise de páginas baseada em arquivos mais confiável, detecção de candidatos a Tailwind, modo de redefinição, isolamento do cache de renderização e pré-carregamentos do editor.

Biblioteca UI

A versão 7.3 inclui uma biblioteca de componentes agrupada e aplicativos de exemplo criados com ela.

Componentes UI

Blockstudio 7.3 inclui uma biblioteca de UI agrupada, no namespace bsui/*. Os componentes são blocos Blockstudio comuns, portanto podem ser renderizados em templates, páginas baseadas em arquivos, padrões e conteúdo de publicações usando a mesma sintaxe de tags de bloco que você já utiliza.

A biblioteca de componentes UI está em beta enquanto coletamos mais comentários. O objetivo da versão 7.3 é disponibilizar o primeiro conjunto de componentes, aprender com projetos reais e aprimorar os nomes, o comportamento e os padrões antes de considerar estável a interface API.

A biblioteca é opcional:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

Depois de ativados, componentes simples podem ser renderizados diretamente:

HTML
<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>

A sintaxe mais curta bs: também funciona:

HTML
<bs:bsui-button label="Save" variant="default" />

O objetivo não é transformar Blockstudio em um kit UI de criação de páginas. É disponibilizar elementos básicos comuns de interface como blocos, para que os aplicativos criados com Blockstudio não precisem recriar botões, caixas de diálogo, abas, seletores, campos de formulário, menus, barras de ferramentas e componentes de feedback em cada projeto.

O primeiro conjunto de componentes inclui elementos básicos de layout, ações, campos de entrada, sobreposições, navegação, feedback, formulários e exibição de dados:

  • bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
  • bsui/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-picker
  • bsui/dialog, bsui/drawer, bsui/popover, bsui/menu, bsui/context-menu, bsui/menubar, bsui/tooltip, bsui/alert-dialog
  • bsui/tabs, bsui/accordion, bsui/breadcrumb, bsui/pagination, bsui/navigation-menu
  • bsui/card, bsui/table, bsui/stack, bsui/separator, bsui/aspect-ratio, bsui/badge, bsui/avatar, bsui/progress, bsui/meter, bsui/skeleton, bsui/spinner, bsui/kbd
  • bsui/form, bsui/field, bsui/field-group, bsui/file-upload, bsui/color-picker, bsui/rating

Muitos deles são blocos compostos. Um bloco bsui/tabs controla o estado interativo, enquanto blocos filhos como bsui/tabs-list, bsui/tabs-trigger e bsui/tabs-panel descrevem a estrutura.

HTML
<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>

Assim, a marcação permanece legível, enquanto a API de Interatividade API cuida do estado e do comportamento.

Exemplos de aplicativos

O namespace app/* contém exemplos criados com os mesmos componentes UI.

Eles não formam um framework separado. São implementações de referência para interfaces Blockstudio maiores: blocos compostos, UI aninhados, estado da API de Interatividade API e pontos em que componentes UI se integram a recursos de RPC ou vinculados a bancos de dados.

HTML
<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>

A biblioteca UI também inclui sua própria documentação e uma referência interativa de componentes. O comportamento dos componentes não é apenas uma coleção de templates. Faz parte do contrato do framework e permanece coerente conforme a biblioteca cresce.

Criação e edição

Várias mudanças facilitam a criação e a edição de blocos.

Editor ampliado

Editar blocos complexos na barra lateral do inspetor pode ficar difícil rapidamente. Isso é especialmente verdade para repetidores, campos de código, texto formatado e grupos aninhados.

Blockstudio 7.3 adiciona uma ação de edição ampliada ao inspetor de blocos. Ela abre um painel mais largo no lado direito do editor e exibe os mesmos campos Blockstudio.

O ponto principal é que esse continua sendo o mesmo sistema de campos. Ele não duplica a renderização dos campos nem introduz um segundo fluxo de persistência, e as mudanças feitas no editor ampliado atualizam o bloco selecionado, assim como as feitas na barra lateral normal.

Use esse recurso quando a barra lateral for adequada para examinar os campos, mas apertada demais para inserir dados.

Seletores de recursos com escopo

Blockstudio já oferecia suporte a %selector% para campos de código. Na versão 7.3, os recursos CSS e SCSS de blocos podem usar o mesmo padrão de criação.

Em um arquivo CSS, %selector% se expande para a classe com escopo do bloco:

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

Isso permite estilizar o elemento contêiner real:

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>

Os seletores comuns em *.scoped.css continuam direcionados aos descendentes. %selector% é o hook explícito para o elemento raiz do bloco.

Dependências de plugins

Agora, os blocos podem declarar dependências de plugins WordPress dentro da chave blockstudio de block.json.

A forma simples verifica se cada slug de plugin listado está ativo:

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

A forma de objeto adiciona restrições de versão:

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

Os identificadores são slugs de plugins WordPress, correspondentes ao sistema de dependências de plugins do núcleo do WordPress. Blockstudio resolve os plugins ativos para esses slugs e ignora o registro se um plugin obrigatório estiver ausente, inativo ou abaixo da versão exigida.

A restrição de versão usa o mesmo modelo de comparação de PHP version_compare(). Uma versão simples como "6" é interpretada como >=6.

Isso é útil para blocos que só fazem sentido quando há um plugin disponível: cartões de produtos WooCommerce, integrações de formulários, integrações com SEO, componentes de associação, widgets de reserva ou UI administrativos vinculados a um plugin de terceiros.

Políticas do editor

O arquivo blockstudio.json também está se tornando mais útil como arquivo de políticas do editor no nível do projeto.

A versão 7.3 adiciona uma camada de políticas blockEditor baseada em PHP para as configurações que WordPress já disponibiliza por meio de hooks do lado do servidor. Assim, você pode definir globalmente o comportamento do inseridor, dos padrões e das mídias sem incluir código improvisado específico para o tema.

JSON
{
  "$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"]
      }
    }
  }
}

A primeira versão se limita intencionalmente ao que tem suporte em PHP: blocos permitidos e bloqueados, carregamento do diretório de blocos, rótulos e ordem das categorias do inseridor, fontes e categorias de padrões, Openverse, opções de tamanho de imagem, visibilidade de widgets legados e remoção de estilos de bloco registrados por PHP.

O recurso não tenta reescrever padrões arbitrários dos blocos do núcleo. Configurações como core/columns.isStackedOnMobile fazem parte do fluxo de registro JavaScript do editor de blocos, então exigem um API separado e mais explícito, em vez de serem inseridas à força em um arquivo JSON.

Aliases de tags de bloco

As tags de bloco ganharam um filtro de alias:

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

Isso permite que um projeto defina tags mais fáceis de escrever, que ainda resolvem internamente para o nome canônico do bloco.

HTML
<bs:theme-button label="Continue" />

Isso é especialmente útil ao compor templates com muitos UI, nos quais os nomes canônicos dos blocos estão corretos, mas nem sempre são os mais práticos para escrever.

Ferramentas e confiabilidade

A análise estática, a confiabilidade e as ferramentas de desempenho avançaram.

Análise estática e documentação gerada

A extensão PHPStan passou a aceitar raízes explícitas de varredura de bibliotecas externas de blocos. Assim, um projeto pode validar tags <bs:*> e <block> em relação a blocos fora do plugin ou tema atual, mantendo essas raízes disponíveis apenas para análise no registro.

As verificações de esquema também foram ampliadas para incluir metadados de página e pluginDependencies, facilitando a detecção de configurações de lançamento inválidas antes que cheguem ao WordPress.

Agora, a geração de documentação inclui referências de filtros para configurações e hooks PHP. Isso é ainda mais importante à medida que blockstudio.json se torna um verdadeiro arquivo de políticas do projeto, em vez de apenas alguns interruptores dispersos.

Confiabilidade de páginas e do editor

A versão 7.3 também inclui várias correções para páginas baseadas em arquivos, renderização do editor e modo de redefinição.

A análise de páginas baseada em arquivos agora lida com mapeamentos personalizados de contêineres com reconhecimento de atributos durante a análise de HTML. As tags de página bs: também resolvem corretamente namespaces de blocos com hífen, então nomes como custom-theme/card não confundem mais o analisador.

Tags genéricas de contêiner que não são do núcleo agora serializam innerContent válido quando não fornecem marcação de wrapper. Isso torna o conteúdo sincronizado das páginas mais previsível e mantém válida a serialização de blocos WordPress.

O editor recebeu um conjunto de correções relacionadas ao comportamento da pré-visualização e do pré-carregamento:

  • O CSS de Tailwind no editor agora inclui candidatos a classes encontrados nos templates de páginas baseados em arquivos.
  • Os pré-carregamentos do editor preservam as classes dos elementos envolventes RichText para blocos repetidos do mesmo tipo.
  • Os pré-carregamentos do editor reconhecem blocos cujos valores padrão dos campos são expandidos pelo Gutenberg, mas omitidos da marcação de bloco salva.
  • Os atributos padrão registrados que o Gutenberg expande são ignorados antes da comparação das chaves do cache de renderização.
  • As renderizações de pré-visualização do editor e do inseridor agora mantêm entradas de cache separadas, mesmo quando compartilham um ID de cliente.
  • bs_get_group() agora funciona corretamente com grupos de campos personalizados reutilizados, inclusive quando o ID do grupo coincide com o nome do campo personalizado, e extrai apenas prefixos exatos de grupo.
  • Os campos de link com withCreateSuggestion agora conectam corretamente o fluxo de criação do WordPress LinkControl e criam páginas de rascunho pela REST API.
  • Os templates de bloco PHP agora são executados uma única vez por renderização, em vez de uma inclusão prévia cujo resultado era descartado.

O modo de redefinição também foi aprimorado. Agora ele neutraliza as regras de largura e margem vertical dos blocos do editor Gutenberg para os tipos de post configurados, remove os estilos de conteúdo/redefinição do iframe WordPress quando necessário e oferece sobreposições mais limpas de foco/seleção para Blockstudio.

A cobertura de regressão para padrões complexos de InnerBlocks também foi ampliada para incluir blocos Blockstudio aninhados, de modo que o caminho de renderização do editor seja verificado em relação aos casos de inserção de padrões mais difíceis de identificar manualmente.

Ferramentas de desempenho

As sondagens locais anônimas de blockstudio-perf=1 agora podem emitir cabeçalhos Server-Timing sem injetar o painel de depuração.

Os tempos medidos também abrangem mais etapas do ciclo de compilação: descoberta, processamento de recursos, registro e substituições. Assim fica mais fácil ver onde o tempo está sendo gasto, sem ativar um UI de criação de perfil visível.

Por que esta versão é importante

O tema central da versão 7.3 é a composição.

Os componentes UI facilitam a composição de interfaces de aplicativos. O Editor expandido facilita a edição de blocos maiores. As dependências de plugins permitem que os blocos descrevam o contexto de plugin de que precisam. As políticas do editor transferem as regras do editor de blocos no nível do projeto para blockstudio.json. Os aliases de tags de bloco tornam a criação de modelos mais prática. As correções no analisador, em PHPStan e no editor tornam essas composições mais confiáveis ao passarem por WordPress.

Blockstudio continua baseado em arquivos. Os blocos continuam sendo pastas. Os modelos continuam fazendo o trabalho. Mas agora a estrutura conta com uma camada de UI mais robusta sobre essa base.