acf_enqueue_script()


WordPressのacf_enqueue_script()関数は、Advanced Custom Fields(ACF)プラグインで使用されるスクリプトをエンキュー(読み込み)するための関数です。

構文

acf_enqueue_script( array $args = array() );

引数の説明:

  • $args(array) — スクリプトの設定を指定する連想配列。以下のキーを使用できます:
    • handle(string) — スクリプトのハンドル名。
    • src(string) — スクリプトのURL。
    • deps(array) — 依存するスクリプトのハンドル名の配列。
    • ver(string|bool) — スクリプトのバージョン。
    • in_footer(bool) — スクリプトをフッターで読み込むかどうか。

例1: 基本的なスクリプトのエンキュー

以下の例では、カスタムスクリプトをエンキューします。

acf_enqueue_script( array( 'handle' => 'custom-script', 'src' => get_template_directory_uri() . '/js/custom-script.js', 'deps' => array( 'jquery' ), 'ver' => '1.0.0', 'in_footer' => true ) );

例2: 依存関係なしでスクリプトをエンキュー

依存関係を指定せずにスクリプトをエンキューします。

acf_enqueue_script( array( 'handle' => 'simple-script', 'src' => get_template_directory_uri() . '/js/simple-script.js', 'ver' => '1.0.0' ) );

例3: フッターにスクリプトを読み込む

スクリプトをフッターで読み込む設定です。

acf_enqueue_script( array( 'handle' => 'footer-script', 'src' => get_template_directory_uri() . '/js/footer-script.js', 'in_footer' => true ) );

例4: バージョン指定なしでスクリプトをエンキュー

バージョン番号を指定せずにスクリプトをエンキューします。

acf_enqueue_script( array( 'handle' => 'no-version-script', 'src' => get_template_directory_uri() . '/js/no-version-script.js' ) );

例5: 複数の依存関係を持つスクリプト

複数の依存関係を持つスクリプトをエンキューします。

acf_enqueue_script( array( 'handle' => 'multi-deps-script', 'src' => get_template_directory_uri() . '/js/multi-deps-script.js', 'deps' => array( 'jquery', 'underscore' ), 'ver' => '1.0.0' ) );

注意点

  • スクリプトのハンドル名は一意である必要があります。
  • 依存関係を正しく設定しないと、スクリプトが正常に動作しない場合があります。