wp_enqueue_script函数用于向WordPress主题或插件中添加脚本文件。它有以下几个参数:

1. $handle:脚本的唯一标识符,用于在其他地方引用脚本。例如,如果要添加一个名为"custom-script"的脚本,可以将$handle设置为"custom-script"。
2. $src:脚本文件的URL。可以是本地文件路径或远程URL。例如,如果要添加一个名为"custom-script.js"的本地脚本文件,可以将$src设置为主题目录下的路径(例如get_template_directory_uri() . '/js/custom-script.js')。如果要添加一个来自CDN的脚本,可以将$src设置为CDN的URL(例如'https://cdn.example.com/custom-script.js')。
3. $deps:依赖关系数组,用于指定脚本的依赖关系。可以是其他已经添加的脚本的$handle数组。这将确保在加载当前脚本之前首先加载依赖脚本。
4. $ver:脚本的版本号。可以是字符串或数字。如果不指定版本号,WordPress将根据修改时间作为默认版本号。为了避免缓存问题,建议在每次更新脚本时使用一个新的版本号。
5. $in_footer:一个布尔值,用于指示脚本是应该放在页面的头部(false)还是页脚(true)。通常,脚本应该放在页脚以确保页面内容能够首先加载。
6. $media:一个字符串,用于指定脚本的媒体查询条件。例如,如果脚本仅适用于移动设备,则可以将$media设置为"(max-width: 768px)"。

下面是一个示例代码,演示如何使用wp_enqueue_script函数在WordPress主题中添加脚本:

function custom_scripts() {
wp_enqueue_script( 'custom-script', get_template_directory_uri() . '/js/custom-script.js', array( 'jquery' ), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'custom_scripts' );

在上面的示例中,我们在主题的functions.php文件中定义了一个名为custom_scripts的函数,并将该函数添加到wp_enqueue_scripts动作钩子中。在custom_scripts函数中,我们使用wp_enqueue_script函数添加了一个名为custom-script的脚本文件。该脚本文件位于主题目录的js子目录中,并依赖于jQuery库(已经在WordPress中默认加载)。该脚本将在页脚加载,并具有版本号为1.0。

希望这个详细的用法教程解析对你有帮助!