wp_script_is()


WordPress関数wp_script_is()は、特定のスクリプトがキューに登録されているか、または実行されているかを確認するために使用されます。

構文

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

引数の説明:

  • $handle (string) — チェックするスクリプトのハンドル。
  • $list (string) — チェック対象のリスト。使用可能な値は次の通り:
    • 'enqueued': キューに登録されているかを確認。
    • 'registered': 登録されているかを確認。
    • 'to_do': 実行待ちかを確認。

例 1. スクリプトがキューに登録されているか確認

次のコードは、スクリプトjqueryがキューに登録されているか確認します。

<?php if ( wp_script_is( 'jquery', 'enqueued' ) ) { echo 'jQuery is enqueued.'; } ?>

例 2. スクリプトが登録されているか確認

スクリプトmy-scriptが登録されている場合にメッセージを出力します。

<?php if ( wp_script_is( 'my-script', 'registered' ) ) { echo 'My script is registered.'; } ?>

例 3. 実行待ちのスクリプトを確認

スクリプトcustom-scriptが実行待ち状態か確認します。

<?php if ( wp_script_is( 'custom-script', 'to_do' ) ) { echo 'Custom script is in the to-do list.'; } ?>

例 4. 条件に応じたスクリプトの読み込み

スクリプトが登録されていない場合に、スクリプトを登録してキューに追加します。

<?php
if ( ! wp_script_is( 'my-script', 'registered' ) ) {
    wp_register_script( 'my-script', get_template_directory_uri() . '/js/my-script.js' );
    wp_enqueue_script( 'my-script' );
}
?>

例 5. キューに登録されているスクリプトのカスタマイズ

特定のスクリプトがキューに登録されている場合にスタイルを追加します。

<?php
if ( wp_script_is( 'jquery', 'enqueued' ) ) {
    wp_add_inline_script( 'jquery', 'console.log("jQuery is loaded.");' );
}
?>

注意事項

  • 関数はフロントエンドまたは管理画面で適切にキューを処理するために使用してください。
  • $handleは正確に指定する必要があります。

関連機能：