wp_enqueue_block_style() の使い方｜説明・引数・注意点

説明

基本構文

wp_enqueue_block_style( string $block_name, array $args ): void

引数

• $block_name：ブロック名（例：core/button）
• $args：handle、src、path など

戻り値

戻り値はありません。

使い方（サンプル）

wp_enqueue_block_style( 'core/button', array(
	'handle' => 'my-button-style',
	'src'    => get_theme_file_uri( 'css/button.css' ),
) );

注意点

• そのブロックが使われているページでだけ出力されます。
• ブロックテーマ・ブロックエディターを使うサイトで有効です。

実務での使いどころ

• 特定のブロックに、独自のスタイルを追加するとき。
• ブロックを使っているページだけで、CSSを読み込みたいとき。

よくあるミスと対処

• ブロック名を、名前空間なしで指定している。core/paragraph のように、名前空間付きで指定する。
• handle が、他のスタイルと重なっている。
• src を指定せず、CSSが読み込まれない（handle と src は、実質、必須）。

NG例

wp_enqueue_block_style( 'paragraph', array( 'handle' => 'my-p', 'src' => get_theme_file_uri( '/css/p.css' ) ) ); // 名前空間がない

OK例

add_action( 'init', function () {
	wp_enqueue_block_style( 'core/paragraph', array(
		'handle' => 'my-paragraph',
		'src'    => get_theme_file_uri( '/css/paragraph.css' ),
	) );
} );

使い分け早見表

関連項目

wp_enqueue_style()、register_block_type()

公式リファレンス：wp_enqueue_block_style() | Function | WordPress Developer Resources