wp_enqueue_editor_format_library_assets()


WordPressのwp_enqueue_editor_format_library_assets()関数は、エディターのフォーマットライブラリ(太字、斜体、リンクなどのフォーマットツール)に必要なアセット(CSSやJS)をエンキュー(読み込み)するために使用されます。主にブロックエディターやクラシックエディターのフォーマットツールバーを表示する際に利用されます。

構文

wp_enqueue_editor_format_library_assets();

例1: 基本的な使用法

エディターのフォーマットライブラリのアセットを読み込む基本的な例です。

add_action('admin_enqueue_scripts', function() { wp_enqueue_editor_format_library_assets(); });

例2: カスタムスクリプトと一緒に使用

カスタムスクリプトと一緒にフォーマットライブラリのアセットを読み込む例です。

add_action('admin_enqueue_scripts', function() { wp_enqueue_editor_format_library_assets(); wp_enqueue_script('custom-script', get_template_directory_uri() . '/js/custom.js'); });

例3: 特定のページでのみ使用

特定の管理ページでのみフォーマットライブラリのアセットを読み込む例です。

add_action('admin_enqueue_scripts', function($hook) { if ($hook === 'post.php') { wp_enqueue_editor_format_library_assets(); } });

例4: クラシックエディターでの使用

クラシックエディターでフォーマットライブラリのアセットを読み込む例です。

add_action('admin_enqueue_scripts', function() { if (class_exists('Classic_Editor')) { wp_enqueue_editor_format_library_assets(); } });

例5: ブロックエディターでの使用

ブロックエディターでフォーマットライブラリのアセットを読み込む例です。

add_action('enqueue_block_editor_assets', function() { wp_enqueue_editor_format_library_assets(); });

例6: カスタム投稿タイプでの使用

特定のカスタム投稿タイプでのみフォーマットライブラリのアセットを読み込む例です。

add_action('admin_enqueue_scripts', function($hook) { global $post; if ($hook === 'post-new.php' && $post->post_type === 'custom_post_type') { wp_enqueue_editor_format_library_assets(); } });

例7: 複数のアセットを同時に読み込む

フォーマットライブラリのアセットと他のアセットを同時に読み込む例です。

add_action('admin_enqueue_scripts', function() { wp_enqueue_editor_format_library_assets(); wp_enqueue_style('custom-style', get_template_directory_uri() . '/css/custom.css'); });

注意点

  • wp_enqueue_editor_format_library_assets()は、主に管理画面で使用されるため、フロントエンドでの使用は避けてください。
  • この関数は引数を持たないため、必要に応じてフックや条件分岐を使用して制御してください。

関連機能: