コンテンツへスキップ

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通り。

エディターUI
create-blockいいえ: 自分で記述するReact編集コンポーネント
Blockstudioはい: block.jsonのフィールドから生成
ビルド工程
create-blockいいえ: ブロックの読み込み前にwp-scriptsでビルド
Blockstudioはい: なし。テンプレートとアセットはファイルとして読み込まれます
エディターのプレビュー
create-blockいいえ: 出力とは別の編集コンポーネント
Blockstudioはい: 同じサーバー側レンダリングのテンプレート
後からマークアップを変更する場合
create-blockいいえ: デフォルトでは静的。save()の変更には非推奨化が必要
Blockstudioはい: 既存のブロックはテンプレートから再レンダリングされます
Interactivity API
create-blockはい: インタラクティブなテンプレート、モジュールビルドフラグ
Blockstudioはい: フラグは1つ。script.jsはモジュールとして読み込まれます
カスタムエディター操作
create-blockはい: Reactでできることなら何でも
Blockstudioいいえ: フィールド、カスタムフィールドコントロール、RichText、InnerBlocks、メディア
ライセンス
create-blockはい: 無料、GPL-2.0-or-later
Blockstudioはい: 無料、GPLv2以降

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にテンプレートを記述すれば、フォルダーを作成した時点でブロックがエディターに表示されます。

出典、チェック済み

Plus

公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

  • 500+のサイトテンプレート
  • AIシステム向け指示
  • 無期限アップデート
  • 非公開Discordコミュニティ