register_block_core_query()


WordPressのregister_block_core_query()関数は、コアのクエリブロックを登録するために使用されます。この関数は、ブロックエディタ内でクエリベースのブロックを管理するための基本的な機能を提供します。

構文

register_block_core_query( array $args );

引数の説明:

  • $args(array) — ブロックの設定オプションを含む配列。
  • $args['name'](string) — ブロックの名前。
  • $args['title'](string) — ブロックのタイトル。
  • $args['category'](string) — ブロックのカテゴリ。
  • $args['icon'](string) — ブロックのアイコン。
  • $args['render_callback'](callable) — ブロックのレンダリングコールバック関数。

例1: 基本的なクエリブロックの登録

この例では、シンプルなクエリブロックを登録します。

register_block_core_query( array( 'name' => 'core/query', 'title' => 'クエリ', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block' ) );

例2: カスタムレンダリングコールバックの使用

カスタムレンダリングコールバックを使用してクエリブロックをレンダリングします。

function custom_render_query_block( $attributes ) { return '<div class="custom-query-block">カスタムクエリブロック</div>'; } register_block_core_query( array( 'name' => 'core/query', 'title' => 'カスタムクエリ', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'custom_render_query_block' ) );

例3: カスタムアイコンの設定

カスタムアイコンを設定してクエリブロックを登録します。

register_block_core_query( array( 'name' => 'core/query', 'title' => 'カスタムアイコンブロック', 'category' => 'widgets', 'icon' => 'smiley', 'render_callback' => 'render_core_query_block' ) );

例4: カスタムカテゴリの設定

カスタムカテゴリを使用してクエリブロックを登録します。

register_block_core_query( array( 'name' => 'core/query', 'title' => 'カスタムカテゴリブロック', 'category' => 'custom-category', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block' ) );

例5: 複数のブロックを一度に登録

複数のクエリブロックを一度に登録します。

register_block_core_query( array( 'name' => 'core/query-1', 'title' => 'クエリ1', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block' ) ); register_block_core_query( array( 'name' => 'core/query-2', 'title' => 'クエリ2', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block' ) );

例6: カスタム属性の追加

カスタム属性を追加してクエリブロックを登録します。

register_block_core_query( array( 'name' => 'core/query', 'title' => 'カスタム属性ブロック', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block', 'attributes' => array( 'custom_attr' => array( 'type' => 'string', 'default' => 'default_value' ) ) ) );

例7: カスタムスクリプトの追加

クエリブロックにカスタムスクリプトを追加します。

register_block_core_query( array( 'name' => 'core/query', 'title' => 'カスタムスクリプトブロック', 'category' => 'widgets', 'icon' => 'admin-post', 'render_callback' => 'render_core_query_block', 'script' => 'custom-script-handle' ) );

注意点

  • ブロックの登録はinitフック内で行う必要があります。
  • カスタムレンダリングコールバックは、適切なHTMLを返す必要があります。
  • ブロックの属性は慎重に設計する必要があります。

関連機能：