enqueue_editor_block_styles_assets()


WordPressのenqueue_editor_block_styles_assets()関数は、ブロックエディター用のスタイルアセットをキューに登録するために使用されます。

構文

enqueue_editor_block_styles_assets( string $handle, string $src = '', array $deps = array(), string|bool|null $ver = false, string $media = 'all' );

引数の説明:

  • $handle(string)— スタイルシートのハンドル名
  • $src(string)— スタイルシートのパス（オプション）
  • $deps(array)— 依存関係のあるハンドルの配列
  • $ver(string|bool|null)— バージョン番号
  • $media(string)— メディアタイプ（例: ‘all’, ‘print’）

例1: 基本的なスタイルの追加

ブロックエディターにカスタムスタイルを追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('my-custom-style',get_template_directory_uri().'/editor-style.css');});

例2: 依存関係のあるスタイルの追加

既存のスタイルに依存するスタイルを追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('my-dependent-style',get_stylesheet_directory_uri().'/dependent-style.css',array('wp-edit-blocks'));});

例3: バージョン番号の指定

スタイルにバージョン番号を追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('versioned-style',get_stylesheet_directory_uri().'/style.css',array(),'1.0.0');});

例4: メディアクエリ用スタイル

印刷用のスタイルを追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('print-style',get_stylesheet_directory_uri().'/print.css',array(),false,'print');});

例5: テーマ内の複数スタイル追加

複数のスタイルを一度に追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('style-one',get_template_directory_uri().'/style-one.css');enqueue_editor_block_styles_assets('style-two',get_template_directory_uri().'/style-two.css');});

例6: プラグインからのスタイル追加

プラグインからスタイルを追加します。

add_action('enqueue_block_editor_assets',function(){enqueue_editor_block_styles_assets('plugin-style',plugins_url('css/editor.css',__FILE__));});

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

特定の投稿タイプでのみスタイルを追加します。

add_action('enqueue_block_editor_assets',function(){if(get_post_type()==='product'){enqueue_editor_block_styles_assets('product-style',get_template_directory_uri().'/product-editor.css');}});

注意点

  • この関数はブロックエディター専用です
  • wp_enqueue_style()とは異なる動作をします
  • フロントエンド用のスタイルには使用できません

関連機能：