render_block_core_template_part()


WordPressのrender_block_core_template_part()関数は、テンプレートパーツブロックをレンダリングするために使用されます。この関数は、テーマやプラグインで再利用可能なテンプレートパーツを動的に表示する際に役立ちます。

構文

render_block_core_template_part( array $attributes );

引数の説明:

  • $attributes(array) — テンプレートパーツブロックの属性を指定します。以下のキーを含むことができます：
    • slug(string) — テンプレートパーツのスラグ。
    • theme(string) — テンプレートパーツが属するテーマ。
    • tagName(string) — ラッパー要素のHTMLタグ名。

例1: 基本的なテンプレートパーツのレンダリング

この例では、指定されたスラグとテーマを使用してテンプレートパーツをレンダリングします。

echo render_block_core_template_part( array( 'slug' => 'header', 'theme' => 'twentytwentyone' ) );

例2: カスタムHTMLタグを使用したレンダリング

この例では、tagNameを使用してラッパー要素をカスタマイズします。

echo render_block_core_template_part( array( 'slug' => 'footer', 'theme' => 'twentytwentyone', 'tagName' => 'footer' ) );

例3: 現在のテーマのテンプレートパーツをレンダリング

現在のテーマのテンプレートパーツをレンダリングする例です。

echo render_block_core_template_part( array( 'slug' => 'sidebar' ) );

例4: テンプレートパーツのスラグのみ指定

テーマを指定せずにスラグのみを使用してテンプレートパーツをレンダリングします。

echo render_block_core_template_part( array( 'slug' => 'navigation' ) );

例5: カスタムテーマのテンプレートパーツをレンダリング

カスタムテーマのテンプレートパーツをレンダリングする例です。

echo render_block_core_template_part( array( 'slug' => 'hero', 'theme' => 'my-custom-theme' ) );

例6: 複数の属性を指定したレンダリング

複数の属性を指定してテンプレートパーツをレンダリングします。

echo render_block_core_template_part( array( 'slug' => 'header', 'theme' => 'twentytwentyone', 'tagName' => 'header', 'className' => 'site-header' ) );

例7: テンプレートパーツの属性を動的に指定

動的に属性を指定してテンプレートパーツをレンダリングします。

$attributes = array( 'slug' => get_post_field( 'post_name', get_post() ), 'theme' => wp_get_theme()->get( 'TextDomain' ) ); echo render_block_core_template_part( $attributes );

注意点

  • テンプレートパーツのスラグが存在しない場合、関数は何も返しません。
  • テーマが指定されていない場合、現在のテーマがデフォルトで使用されます。
  • HTMLタグ名が無効な場合、デフォルトのdivタグが使用されます。

関連機能：