wp_add_global_styles_for_blocks()


WordPressのwp_add_global_styles_for_blocks()関数は、ブロックエディタで使用されるグローバルスタイルを追加するために使用されます。この関数は、テーマやプラグインがブロックに適用するスタイルを一元的に管理するのに役立ちます。

構文

wp_add_global_styles_for_blocks( array $styles );
  • $styles (array) — ブロックに適用するスタイルの配列。キーはブロック名、値はスタイルのプロパティ。

例1: 基本的なグローバルスタイルの追加

この例では、段落ブロックにグローバルスタイルを追加します。

wp_add_global_styles_for_blocks(array('core/paragraph' => array('color' => 'red')));

例2: 複数のブロックにスタイルを適用

複数のブロックに異なるスタイルを適用する例です。

wp_add_global_styles_for_blocks(array('core/heading' => array('fontSize' => '24px'), 'core/paragraph' => array('lineHeight' => '1.6')));

例3: カスタムブロックにスタイルを追加

カスタムブロックにスタイルを追加する例です。

wp_add_global_styles_for_blocks(array('my-custom/block' => array('backgroundColor' => '#f0f0f0')));

例4: スタイルの上書き

既存のスタイルを上書きする例です。

wp_add_global_styles_for_blocks(array('core/button' => array('borderRadius' => '0')));

例5: スタイルの削除

スタイルを削除する例です。

wp_add_global_styles_for_blocks(array('core/image' => array()));

例6: 条件付きスタイルの追加

条件に基づいてスタイルを追加する例です。

if(is_single()){wp_add_global_styles_for_blocks(array('core/quote' => array('borderLeft' => '4px solid #000')));}

例7: 動的なスタイルの追加

動的にスタイルを追加する例です。

$dynamic_style = array('core/list' => array('padding' => '10px')); wp_add_global_styles_for_blocks($dynamic_style);

注意点

  • この関数は、テーマやプラグインの初期化時に呼び出す必要があります。
  • スタイルが正しく適用されるように、ブロック名を正確に指定してください。
  • スタイルの競合を避けるために、既存のスタイルを上書きする際は注意が必要です。

関連機能：