Blockstudioとcreate-blockを比較
同じblock.jsonを、Reactエディターとビルドなしで実現します。
@wordpress/create-blockは、ブロックを始めるための公式サポートツールです。プラグイン、block.json、React編集コンポーネント、webpackビルドが含まれます。Blockstudioはblock.jsonとWordPressブロックAPIをそのまま使い、編集コンポーネントを、フィールドから自動生成されるUIとサーバーがレンダリングするテンプレートに置き換えます。ビルドは不要です。
ビルドなしで変わること
Blockstudioブロックはフォルダーで構成されます。フィールド用のblock.json、マークアップ用のテンプレート、および任意のアセットが同じ場所にあります。
コントロールではなくフィールド
block.jsonでフィールドを宣言すると、そのコントロールが表示されます。テキストからリピーターまで、組み込みの型が27種類あります。
テンプレートは1つ
同じPHP、Twig、またはBladeテンプレートで、エディターのプレビューとページの両方をレンダリングします。
タグとして使うエディターコンポーネント
テンプレートにRichTextまたはInnerBlocksタグを記述すると、エディターがReactに置き換えます。
ファイル名でアセットを読み込み
style.scssはサーバー上でコンパイルされ、npmのインポートはscript.jsにダウンロードされてブロックに含まれます。
create-blockを選ぶのが適している場合
編集体験そのものが製品となる場合。カスタムツールバー、ドラッグ操作、キャンバスなど、エディター内でReact状態が必要な機能を使う場合。PHPなしでレンダリングできる静的マークアップを保存する必要がある場合。チームがすでにReactを使っていて、@wordpress/componentsライブラリをすべて活用したい場合にも適しています。
CoreもPHPへと移行しています。WordPress7.0以降では、autoRegisterとrenderコールバックを使って登録したブロックに、string、number、integer、boolean属性用のコントロールが自動生成され、JavaScriptは不要です。ただし、RichText、inner blocks、メディアには、引き続き編集コンポーネントが必要です。
併用できます
Blockstudioは、blockstudioキーのないblock.jsonをregister_block_type()経由で登録します。wp-scriptsでcreate-blockブロックをビルドし、出力フォルダーをBlockstudioディレクトリに配置すれば、既存のBlockstudioブロックと並んで読み込まれます。
Blockstudioレジストリはプロジェクト間でブロックフォルダーをコピーします。同じ仕組みで共有できるため、create-blockフォルダーも他のブロックと同じように移動できます。
並べて比較
同じブロックAPIで、エディター側の作成方法は2通り。
create-blockに関する質問
ビルドを省くことについて、ブロック開発者からよく寄せられる質問。
Nodeは引き続き必要ですか?
Blockstudioブロックには不要です。テンプレート、SCSS、ES moduleのインポートはPHPが処理します。create-blockプロジェクトではwp-scriptsのためにNodeが必要です。@wordpress/scripts 36.1.0には、Node 22.22.2以降の22.x、24.15.0以降の24.x、またはNode 26以降が必要です。
同じblock.jsonですか?
はい。Blockstudioは標準のblock.jsonを読み込み、フィールドと設定用のblockstudioキーを追加します。name、title、category、supportsなどの意味は、WordPressに記載されているとおりです。
既存のcreate-blockブロックを使い続けられますか?
はい。ビルド出力をBlockstudioディレクトリに配置すると、Blockstudioがregister_block_type()で登録します。独自のプラグインに入れたままでも構いません。生成されるフィールドのほうが適している場合にだけ、ブロックを書き換えてください。
create-blockを選ぶほうがよいのはどんな場合ですか?
フィールドとテンプレートでは表現できないエディターの動作や、静的な保存出力が必要な場合、またはチームがすでにReactで作業している場合です。Blockstudioは、編集コンポーネントの大部分が定型コードになるような、フィールドとマークアップで構成される多くのブロックに適しています。
InteractivityAPIはどうなりますか?
どちらもサポートしています。create-blockのインタラクティブテンプレートは、supports.interactivity、viewScriptModule、experimental modulesビルドフラグを設定します。Blockstudioではblockstudioキーの下にインタラクティブ機能を設定すると、script.jsがモジュールとして読み込まれます。インポートマップも自動生成されます。
ブロックを記述して、ビルドを省く
block.jsonにフィールドを、PHP、Twig、またはBladeにテンプレートを記述すれば、フォルダーを作成した時点でブロックがエディターに表示されます。
出典、チェック済み
- ブロックエディターハンドブック:@wordpress/create-block
- ブロックエディターハンドブック:create-blockを使い始める
- ブロックエディターハンドブック:ブロックのファイル構成
- ブロックエディターハンドブック:編集と保存
- ブロックエディターハンドブック:非推奨化
- ブロックエディターハンドブック:静的または動的なレンダリング
- ブロックエディターハンドブック:InteractivityAPI
- ブロックエディターハンドブック:@wordpress/scripts
- ブロックエディターハンドブック:@wordpress/create-block-interactive-template
- npm上の@wordpress/create-block
- npm上の@wordpress/scripts
- Gutenbergソース:create-block-interactive-template
- WordPress Coreにする:PHPのみのブロック登録
公式拡張キット
プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。
- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ