介绍

wp_enqueue_script(
 string $handle, 
 string $src = '',
 array $deps = array(),
 string|bool|null $ver = false,
 bool $in_footer = false 
)

wp_enqueue_script() 是WordPress注册和引用一个js的函数。

参数

$handle

(string) (必填) js名称，必填，并且不能重复。
$src

(string) (选填) 完整的js链接地址。

Default value: ''
$deps

(array) (选填) 数组，此脚本依赖的注册脚本。

Default value: array()
$ver

(string|bool|null) (Optional) String specifying script version number, if it has one, which is added to the URL as a query string for cache busting purposes. If version is set to false, a version number is automatically added equal to current installed WordPress version. If set to null, no version is added.

Default value: false
$in_footer

(bool) (Optional) Whether to enqueue the script before instead of in the . Default 'false'.

Default value: false

示例

注册一个 custom_script.js ，并且该js依赖于jquery才能执行。显示在标签前面。

/**
 * Enqueue a script with jQuery as a dependency.
 */
function wpdocs_scripts_method() {
    wp_enqueue_script( 'custom-script', 
    get_stylesheet_directory_uri() . '/js/custom_script.js', 
    array( 'jquery' ) 
);
}
add_action( 'wp_enqueue_scripts', 'wpdocs_scripts_method' );

去掉 WordPress 自带的jquery，引入一个js。jquery去掉版本号，downbetter.min.js使用其md5作为版本号，jquery与downbetter.min.js都加载在标签前面。

/**
 * Enqueue scripts.
 */
function downbetter_scripts() {
    // 去掉WordPress自带jquery，引用cdn jquery。
    wp_deregister_script('jquery');
    wp_register_script('jquery','https://unpkg.com/jquery@1.12.4/dist/jquery.min.js', array(), null, true );
    wp_enqueue_script('jquery');
    // 注册一个依赖于jquery才能执行的 downbetter.min.js
    $downbetterVer = md5(get_template_directory_uri() .'/js/downbetter.min.js');
    wp_enqueue_script( 'downbetter-script', get_template_directory_uri() . '/js/downbetter.min.js', array( 'jquery' ), $downbetterVer, true );
}
add_action( 'wp_enqueue_scripts', 'downbetter_scripts' );