wp_dequeue_style()


WordPressの関数wp_dequeue_style()は、登録済みのスタイルシートをキューから削除するために使用されます。これにより、特定のページや条件で不要なCSSファイルの読み込みを防ぐことができます。

構文

wp_dequeue_style( string $handle );
  • $handle (string) — 登録されたスタイルシートのハンドル名。

例1: 特定のスタイルシートを削除

この例では、ハンドル名が「my-style」のスタイルシートをキューから削除します。

wp_dequeue_style('my-style');

例2: プラグインのスタイルシートを削除

プラグインが読み込むスタイルシートを削除する例です。

wp_dequeue_style('plugin-style-handle');

例3: テーマのスタイルシートを削除

テーマが読み込むスタイルシートを削除する例です。

wp_dequeue_style('theme-style-handle');

例4: 条件付きでスタイルシートを削除

特定のページでのみスタイルシートを削除する例です。

if (is_page('about')) { wp_dequeue_style('page-specific-style'); }

例5: 複数のスタイルシートを削除

複数のスタイルシートを一度に削除する例です。

wp_dequeue_style('style1'); wp_dequeue_style('style2');

例6: フックを使用してスタイルシートを削除

wp_enqueue_scriptsフックを使用してスタイルシートを削除する例です。

add_action('wp_enqueue_scripts', 'remove_styles'); function remove_styles() { wp_dequeue_style('unnecessary-style'); }

例7: 管理画面でのスタイルシート削除

管理画面で特定のスタイルシートを削除する例です。

add_action('admin_enqueue_scripts', 'remove_admin_styles'); function remove_admin_styles() { wp_dequeue_style('admin-style-handle'); }

例8: カスタム投稿タイプでのスタイルシート削除

特定のカスタム投稿タイプでのみスタイルシートを削除する例です。

if (is_singular('my_custom_post_type')) { wp_dequeue_style('custom-post-style'); }

注意点:

  • スタイルシートを削除する際は、そのスタイルシートが他の機能に影響を与えないか確認してください。
  • wp_dequeue_style()は、wp_enqueue_style()で登録されたスタイルシートに対してのみ有効です。

関連機能：