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

説明

基本構文

wp_enqueue_global_styles(): void

引数

引数はありません。

戻り値

戻り値はありません。

使い方（サンプル）

// 通常はWordPress本体が呼び出す
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );

注意点

• 通常は本体が自動で呼ぶので、自分で呼ぶ必要はありません。
• 不要な場合は remove_action で外すことがあります。

実務での使いどころ

• theme.json のスタイル（グローバルスタイル）を出力する関数。通常は、WordPressが自動で呼ぶ。
• クラシックテーマで、グローバルスタイルを読み込みたくないときに、外す対象として知っておく。

よくあるミスと対処

• 自分で呼ぶ必要は、通常ない。
• theme.json を使うテーマで、これを外し、色・フォント・余白などの見た目が崩れる。
• 外すとき、全ページで確認せずに外している。

NG例

// 確認せずに、すべてのサイトで外している
remove_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );

OK例

add_action( 'after_setup_theme', function () {
	if ( ! wp_is_block_theme() ) {
		remove_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );
		remove_action( 'wp_footer', 'wp_enqueue_global_styles', 1 ); // バージョンによっては、必要
	}
} );
// 外したあとは、全種類のページで、見た目を確認する

使い分け早見表

関連項目

wp_enqueue_style()、wp_dequeue_style()

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