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

説明

基本構文

wp_dequeue_style( string $handle ): void

引数

• $handle：スタイルの識別名

戻り値

戻り値はありません。

使い方（サンプル）

add_action( 'wp_enqueue_scripts', function() {
	wp_dequeue_style( 'wp-block-library' );
}, 100 );

注意点

• 読み込まれた後に呼ぶ必要があるため、優先度を大きくします。
• 他のスタイルが依存している場合、見た目が崩れることがあります。

実務での使いどころ

• プラグインやテーマが読み込むCSSを、特定のページだけ外すとき。
• 使わないCSSを、外して、読み込みを減らすとき。

よくあるミスと対処

• プラグインが読み込みを予約するより前に実行してしまい、効かない。wp_enqueue_scripts フックの優先度を大きく（100 など）して、後で実行する。
• ハンドル名を間違えている。ページのソースで、実際のハンドル名を確認する。
• 他のスタイルが依存しているハンドルは、wp_dequeue_style() で外しても、依存として読み込まれ続ける。CSSを外したことで、見た目が崩れる場合もあるため、外す前後で、表示を確認する。

NG例

add_action( 'wp_enqueue_scripts', function () {
	wp_dequeue_style( 'plugin-style' ); // プラグインより先に実行され、効かない
} );

OK例

add_action( 'wp_enqueue_scripts', function () {
	if ( ! is_page( 'contact' ) ) {
		wp_dequeue_style( 'plugin-style' );
	}
}, 100 );

使い分け早見表

関連項目

wp_enqueue_style()、wp_deregister_style()

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