block_core_heading_render()


WordPressのblock_core_heading_render()関数は、コアブロックの見出し（Heading）をレンダリングするために使用されます。この関数は、Gutenbergエディターで作成された見出しブロックをフロントエンドに表示する際に利用されます。

構文

block_core_heading_render( array $attributes, string $content );

引数の説明:

  • $attributes(array) — 見出しブロックの属性を指定します。例えば、レベル（h1, h2など）、テキスト、クラス名などが含まれます。
  • $content(string) — 見出しブロックのコンテンツを指定します。通常は空ですが、フィルタリングや追加のコンテンツを渡す場合に使用されます。

例1: 基本的な見出しのレンダリング

この例では、見出しブロックをレンダリングする基本的な方法を示します。

echo block_core_heading_render( array( 'level' => 2, 'content' => 'こんにちは、世界！' ), '' );

例2: カスタムクラスを追加した見出し

見出しにカスタムクラスを追加する例です。

echo block_core_heading_render( array( 'level' => 3, 'className' => 'custom-heading', 'content' => 'カスタム見出し' ), '' );

例3: 見出しレベルを動的に変更

見出しのレベルを動的に変更する例です。

$level = 4; echo block_core_heading_render( array( 'level' => $level, 'content' => '動的な見出し' ), '' );

例4: 見出しにIDを追加

見出しにID属性を追加する例です。

echo block_core_heading_render( array( 'level' => 2, 'anchor' => 'section-1', 'content' => 'セクション1' ), '' );

例5: 見出しにインラインスタイルを適用

見出しにインラインスタイルを適用する例です。

echo block_core_heading_render( array( 'level' => 2, 'style' => array( 'color' => '#ff0000' ), 'content' => '赤い見出し' ), '' );

例6: フィルターフックを使用してコンテンツを変更

フィルターフックを使用して見出しのコンテンツを変更する例です。

$content = apply_filters( 'custom_heading_content', 'フィルターされた見出し' ); echo block_core_heading_render( array( 'level' => 2, 'content' => $content ), '' );

例7: 見出しにカスタム属性を追加

見出しにカスタムデータ属性を追加する例です。

echo block_core_heading_render( array( 'level' => 2, 'content' => 'カスタム属性', 'data-custom' => 'value' ), '' );

注意点

  • block_core_heading_render()は、WordPressのコアブロックシステムに依存しています。カスタムテーマやプラグインで使用する場合は、互換性を確認してください。
  • 見出しのレベル（h1, h2など）は、SEOやアクセシビリティに影響を与えるため、適切に設定してください。
  • フィルターフックを使用する場合は、他のプラグインやテーマとの競合を避けるために、ユニークなプレフィックスを使用してください。

関連機能：