wp_get_block_name_from_theme_json_path()


WordPressのwp_get_block_name_from_theme_json_path()関数は、テーマのtheme.jsonファイル内のブロック名を取得するために使用されます。この関数は、指定されたパスからブロック名を抽出し、テーマ開発者がブロックの設定を動的に操作するのに役立ちます。

構文

wp_get_block_name_from_theme_json_path( string $path );
  • $path(string) — theme.jsonファイル内のブロックへのパスを指定します。

例1: 基本的なブロック名の取得

theme.jsonファイル内の特定のブロック名を取得します。

$block_name = wp_get_block_name_from_theme_json_path( 'styles/blocks/core/paragraph' );

例2: カスタムブロックの名前を取得

カスタムブロックの名前を取得する例です。

$block_name = wp_get_block_name_from_theme_json_path( 'styles/blocks/custom/my-block' );

例3: ネストされたブロックの名前を取得

ネストされたブロックの名前を取得します。

$block_name = wp_get_block_name_from_theme_json_path( 'styles/blocks/core/group/inner-blocks' );

例4: ブロック名を変数に代入

取得したブロック名を変数に代入して使用します。

$block_name = wp_get_block_name_from_theme_json_path( 'styles/blocks/core/heading' );

例5: ブロック名を直接出力

取得したブロック名を直接出力します。

echo wp_get_block_name_from_theme_json_path( 'styles/blocks/core/image' );

例6: 条件付きでブロック名を取得

条件に基づいてブロック名を取得します。

if ( $path === 'styles/blocks/core/list' ) { $block_name = wp_get_block_name_from_theme_json_path( $path ); }

例7: ブロック名を配列に追加

取得したブロック名を配列に追加します。

$block_names[] = wp_get_block_name_from_theme_json_path( 'styles/blocks/core/quote' );

注意点

  • 指定されたパスがtheme.jsonファイル内に存在しない場合、関数はnullを返します。
  • パスの形式が正しくない場合、予期しない結果が返される可能性があります。

関連機能：