wp_style_is()


WordPressの関数wp_style_is()は、特定のスタイルシートがキューに登録されているか、またはすでに読み込まれているかを確認するために使用されます。

構文

wp_style_is( string $handle, string $list = 'enqueued' );

引数の説明:

  • $handle (string) — 確認するスタイルシートのハンドル名。
  • $list (string) — 確認するリストの種類。デフォルトは'enqueued'。利用可能な値は以下の通り:
    • 'enqueued' — 登録されているかどうかを確認。
    • 'registered' — 登録されているかどうかを確認。
    • 'to_do' — 読み込み待ちリストにあるかどうかを確認。

例 1: スタイルシートが登録されているかを確認

<?php if ( wp_style_is( 'example-style', 'registered' ) ) { echo 'スタイルが登録されています。'; } ?>

例 2: スタイルシートがキューに追加されているかを確認

<?php if ( wp_style_is( 'example-style', 'enqueued' ) ) { echo 'スタイルがキューに追加されています。'; } ?>

例 3: 条件付きでスタイルシートを読み込む

特定のスタイルがキューにない場合のみ、新しいスタイルを追加します。

<?php
if ( ! wp_style_is( 'example-style', 'enqueued' ) ) {
    wp_enqueue_style( 'example-style', get_stylesheet_uri() );
}
?>

例 4: すべての登録スタイルを確認

登録されたスタイルを確認し、メッセージを表示します。

<?php
if ( wp_style_is( 'example-style', 'registered' ) ) {
    echo 'このスタイルは登録されています。';
} else {
    echo 'このスタイルは登録されていません。';
}
?>

例 5: 他の条件と組み合わせて使用

特定の条件を満たす場合にのみ、スタイルの状態を確認します。

<?php
if ( is_admin() && wp_style_is( 'admin-style', 'enqueued' ) ) {
    echo '管理画面でスタイルが適用されています。';
}
?>

注意点

wp_style_is()は正しいハンドル名を使用する必要があります。不正なハンドルを指定すると、結果が正確でない可能性があります。

関連機能：