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.
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
- Manual do editor de blocos: @wordpress/create-block
- Manual do editor de blocos: primeiros passos com create-block
- Manual do editor de blocos: estrutura de arquivos de um bloco
- Manual do editor de blocos: editar e salvar
- Manual do editor de blocos: descontinuação
- Manual do editor de blocos: renderização estática ou dinâmica
- Manual do editor de blocos: API do Interactivity
- Manual do editor de blocos: @wordpress/scripts
- Manual do editor de blocos: @wordpress/create-block-interactive-template
- @wordpress/create-block no npm
- @wordpress/scripts no npm
- Fonte de Gutenberg: create-block-interactive-template
- Criar o Core do WordPress: registro de blocos apenas com PHP
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