wp_dequeue_script_module()


WordPressのwp_dequeue_script_module()関数は、登録されたスクリプトモジュールをキューから削除するために使用されます。これにより、特定のスクリプトモジュールがページに読み込まれないようにすることができます。

構文

wp_dequeue_script_module( string $handle );
  • $handle (string) — キューから削除するスクリプトモジュールのハンドル名。

例1: 特定のスクリプトモジュールをキューから削除

この例では、ハンドル名が「my-script-module」のスクリプトモジュールをキューから削除します。

wp_dequeue_script_module('my-script-module');

例2: 条件付きでスクリプトモジュールを削除

特定の条件が満たされた場合にのみ、スクリプトモジュールをキューから削除します。

if ( !is_front_page() ) { wp_dequeue_script_module('my-script-module'); }

例3: 複数のスクリプトモジュールを削除

複数のスクリプトモジュールを一度にキューから削除します。

wp_dequeue_script_module('module-1'); wp_dequeue_script_module('module-2');

例4: プラグイン内での使用

プラグイン内で特定のスクリプトモジュールを削除する例です。

add_action('wp_enqueue_scripts', function() { wp_dequeue_script_module('plugin-module'); });

例5: テーマ内での使用

テーマ内で特定のスクリプトモジュールを削除する例です。

add_action('wp_enqueue_scripts', function() { wp_dequeue_script_module('theme-module'); });

例6: 特定のページでのみスクリプトモジュールを削除

特定のページでのみスクリプトモジュールを削除します。

if ( is_page('about') ) { wp_dequeue_script_module('about-module'); }

例7: スクリプトモジュールを削除して代替スクリプトを追加

スクリプトモジュールを削除し、代替スクリプトを追加します。

wp_dequeue_script_module('old-module'); wp_enqueue_script_module('new-module', get_template_directory_uri() . '/js/new-module.js');

例8: スクリプトモジュールを削除してカスタムスクリプトを追加

スクリプトモジュールを削除し、カスタムスクリプトを追加します。

wp_dequeue_script_module('default-module'); wp_add_inline_script('custom-script', 'console.log("Custom script loaded");');

注意点

  • スクリプトモジュールが既にキューに登録されていることを確認してください。
  • スクリプトモジュールが依存関係を持っている場合、それらも適切に処理する必要があります。

関連機能：