Pular para o conteúdo

Blockstudio vs create-block

O mesmo block.json, sem o editor React nem a etapa de build.

@wordpress/create-block é a ferramenta com suporte oficial para iniciar um bloco: um plugin, um block.json, um componente de edição React e um build com webpack. Blockstudio mantém block.json e o WordPress do bloco API, substituindo o componente de edição por campos que ele renderiza para você e por um template renderizado pelo servidor, sem nada para compilar.

O que muda sem a etapa de build

Um bloco Blockstudio é uma pasta: block.json para os campos, um template para a marcação e recursos opcionais junto deles.

Campos, não controles

Declare um campo em block.json e o controle aparecerá. 27 tipos integrados, de texto a repetidores.

Um template

O mesmo template PHP, Twig ou Blade renderiza a prévia no editor e a página.

Componentes do editor como tags

Escreva tags RichText ou InnerBlocks no template; o editor as substitui por React.

Assets pelo nome do arquivo

style.scss compila no servidor, e as importações de npm em script.js são baixadas para o bloco.

Quando create-block é a melhor escolha

Quando a experiência de edição é o produto: barras de ferramentas personalizadas, interações de arrastar, telas visuais ou qualquer coisa que exija estado React no editor. Quando um bloco precisa salvar marcação estática que seja renderizada sem PHP. E quando sua equipe já escreve React e quer a biblioteca completa de @wordpress/components.

O Core também está avançando na direção de PHP. Desde WordPress 7.0, um bloco registrado com autoRegister e um callback de renderização recebe controles gerados para atributos de string, number, integer e boolean, sem JavaScript. Texto rico, blocos internos e mídia ainda precisam de um componente de edição nesse caso.

Eles funcionam lado a lado

Blockstudio registra qualquer block.json sem uma chave blockstudio por meio de register_block_type(). Compile um bloco create-block com wp-scripts, coloque a pasta de saída em um diretório Blockstudio e ele será carregado ao lado dos seus blocos Blockstudio.

O registro de Blockstudio copia pastas de blocos entre projetos, então o mesmo vale para o compartilhamento: uma pasta create-block pode ser transferida como qualquer outro bloco.

Lado a lado

O mesmo API de bloco, duas formas de criar o lado do editor.

O editor UI
create-blockNão: Um componente de edição React que você escreve
BlockstudioSim: Gerado a partir dos campos em block.json
Etapa de build
create-blockNão: wp-scripts build antes de o bloco carregar
BlockstudioSim: Nenhuma; templates e recursos são carregados como arquivos
Prévia no editor
create-blockNão: Seu componente de edição, separado da saída
BlockstudioSim: O mesmo template renderizado no servidor
Alterar a marcação depois
create-blockNão: Estático por padrão; alterações em save() exigem descontinuações
BlockstudioSim: Os blocos existentes são renderizados novamente a partir do template
Interactivity API
create-blockSim: Template interativo, sinalizador de build de módulos
BlockstudioSim: Um sinalizador; script.js carrega como módulo
Interações personalizadas no editor
create-blockSim: Tudo o que React pode fazer
BlockstudioNão: Campos, controles de campo personalizados, RichText, InnerBlocks, mídia
Licença
create-blockSim: Gratuito, GPL-2.0-or-later
BlockstudioSim: Gratuito, GPLv2 ou posterior

Perguntas sobre create-block

O que os desenvolvedores de blocos perguntam sobre abandonar a etapa de build.

Ainda preciso do Node?

Não para blocos Blockstudio: templates, SCSS e importações de módulos ES são tratados em PHP. Um projeto create-block precisa do Node para usar wp-scripts, e @wordpress/scripts 36.1.0 exige Node 22.22.2 ou posterior 22.x, 24.15.0 ou posterior 24.x, ou Node 26 ou posterior.

É o mesmo block.json?

Sim. Blockstudio lê um block.json padrão e adiciona uma chave blockstudio para campos e configurações. Nome, título, categoria, supports e o restante significam o que WordPress diz que significam.

Posso manter meus blocos create-block?

Sim. Coloque a saída de build deles em um diretório Blockstudio e Blockstudio os registra com register_block_type(), ou mantenha-os no próprio plugin. Reescreva um bloco somente quando os campos gerados forem mais adequados para ele.

Quando create-block é a melhor escolha?

Quando você precisa de comportamentos no editor que campos e templates não conseguem expressar, saída estática ao salvar ou uma equipe que já trabalha com React. Blockstudio é para os muitos blocos que consistem em campos e marcação, nos quais o componente de edição é, em sua maior parte, código repetitivo.

E quanto à API do Interactivity?

Ambos oferecem suporte. O template interativo de create-block configura supports.interactivity, um viewScriptModule e o sinalizador experimental de build de módulos. Em Blockstudio, você define a interatividade na chave blockstudio, e script.js carrega como módulo com o mapa de importações gerado para você.

Escreva o bloco, pule a etapa de build

Campos em block.json, um template em PHP, Twig ou Blade, e um bloco que aparece no editor assim que a pasta existe.

Fontes, marcado

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