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

説明

基本構文

wp_style_is( string $handle, string $status = 'enqueued' ): bool

引数

• $handle：スタイルの識別名
• $status：registered / enqueued / done / to_do

戻り値

状態に合致すれば true。

使い方（サンプル）

if ( ! wp_style_is( 'my-style', 'enqueued' ) ) {
	wp_enqueue_style( 'my-style' );
}

注意点

• 既定のステータスは enqueued です。

実務での使いどころ

• スタイルが、すでに読み込みの予約や、登録されているかを確認するとき。
• 他のプラグインが読み込んでいる場合に、二重に読み込まないようにするとき。

よくあるミスと対処

• $status を省略している。既定は enqueued（読み込みの予約済み）で、「登録済み」とは意味が違う。
• wp_enqueue_scripts が終わる前に判定すると、まだ予約されていない。
• 「出力済み」を調べたいのに、enqueued で判定している。出力済みは done。

NG例

if ( wp_style_is( 'my-style' ) ) {
	// 登録済みかを確認したつもり（予約済みかを確認している）
}

OK例

if ( wp_style_is( 'my-style', 'registered' ) ) {
	wp_enqueue_style( 'my-style' );
}

使い分け早見表

関連項目

wp_script_is()、wp_enqueue_style()

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