wp_dequeue_script()


WordPressのwp_dequeue_script()関数は、すでに登録またはキューに追加されたスクリプトを解除するために使用されます。この関数は特定のスクリプトをロードしないように設定する場合に便利です。

シンタックス

wp_dequeue_script( string $handle );
  • $handle (string) — 解除したいスクリプトのハンドル名。登録時に使用されたハンドル名と一致する必要があります。

例 1: 特定のスクリプトをフロントエンドから解除

以下のコードは、jqueryスクリプトをフロントエンドから解除します。

add_action( 'wp_enqueue_scripts', function() {
    wp_dequeue_script( 'jquery' );
} );

例 2: 管理画面でスクリプトを解除

管理画面でのみ特定のスクリプトを解除する方法です。

add_action( 'admin_enqueue_scripts', function() {
    wp_dequeue_script( 'admin-custom-script' );
} );

例 3: 条件に基づいてスクリプトを解除

特定の条件に基づいてスクリプトを解除します。例えば、特定の投稿タイプのみで解除する場合。

add_action( 'wp_enqueue_scripts', function() {
    if ( is_singular( 'product' ) ) {
        wp_dequeue_script( 'product-slider' );
    }
} );

例 4: プラグインが登録したスクリプトを解除

特定のプラグインが登録したスクリプトを解除します。

add_action( 'wp_enqueue_scripts', function() {
    wp_dequeue_script( 'plugin-specific-script' );
}, 100 );

例 5: 親テーマのスクリプトを解除して子テーマのスクリプトを追加

親テーマのスクリプトを解除し、代わりに子テーマのカスタムスクリプトを追加します。

add_action( 'wp_enqueue_scripts', function() {
    wp_dequeue_script( 'parent-theme-script' );
    wp_enqueue_script( 'child-theme-script', get_stylesheet_directory_uri() . '/js/custom.js', array(), null, true );
} );

注意事項

  • 解除するスクリプトのハンドル名が正確である必要があります。
  • wp_dequeue_script()を使用するフックの優先度に注意してください。適切な順序で実行されるように設定してください。

関連機能：