get_comment_delimited_block_content()


WordPressのget_comment_delimited_block_content()関数は、コメントで区切られたブロックコンテンツを取得するために使用されます。

構文

get_comment_delimited_block_content( string $block_type, string $content );

引数の説明:

  • $block_type(string)—ブロックの種類を指定します。
  • $content(string)—解析するコンテンツ。

例1:基本的なブロックコンテンツの取得

コアの段落ブロックからコンテンツを取得します。

$content = get_comment_delimited_block_content( 'core/paragraph', '<!-- wp:paragraph --><p>テスト</p><!-- /wp:paragraph -->' );

例2:複数ブロックからの特定ブロック抽出

複数のブロックを含むコンテンツから特定のブロックを抽出します。

$content = get_comment_delimited_block_content( 'core/heading', '<!-- wp:paragraph --><p>テキスト</p><!-- /wp:paragraph --><!-- wp:heading --><h2>見出し</h2><!-- /wp:heading -->' );

例3:カスタムブロックのコンテンツ取得

カスタムブロックタイプのコンテンツを取得します。

$content = get_comment_delimited_block_content( 'my-plugin/custom-block', '<!-- wp:my-plugin/custom-block --><div>カスタムコンテンツ</div><!-- /wp:my-plugin/custom-block -->' );

例4:存在しないブロックの処理

存在しないブロックタイプを指定した場合の挙動。

$content = get_comment_delimited_block_content( 'core/nonexistent', '<!-- wp:paragraph --><p>テスト</p><!-- /wp:paragraph -->' );

例5:不正なコンテンツの処理

不正な形式のコンテンツを処理します。

$content = get_comment_delimited_block_content( 'core/paragraph', '<p>コメント区切りなし</p>' );

例6:ネストされたブロックの処理

ネストされたブロック構造から親ブロックを取得します。

$content = get_comment_delimited_block_content( 'core/group', '<!-- wp:group --><div><!-- wp:paragraph --><p>ネストされたコンテンツ</p><!-- /wp:paragraph --></div><!-- /wp:group -->' );

例7:複数一致時の最初のブロック取得

複数一致する場合に最初のブロックを取得します。

$content = get_comment_delimited_block_content( 'core/image', '<!-- wp:image --><img src="1.jpg"/><!-- /wp:image --><!-- wp:image --><img src="2.jpg"/><!-- /wp:image -->' );

注意点

  • ブロックタイプは正確に指定する必要があります。
  • コンテンツが正しい形式でない場合、期待する結果が得られない可能性があります。
  • この関数はGutenbergブロックエディタ用に設計されています。

関連機能：