📌  相关文章
📜  wordpress wp_enqueue_script 页脚 - PHP (1)

📅  最后修改于: 2023-12-03 14:48:32.263000             🧑  作者: Mango

WordPress中的wp_enqueue_script

在WordPress主题中,wp_enqueue_script函数是用来添加JavaScript文件的最常见方法。这个函数可以将所需的JavaScript文件添加到WordPress网站的页面中,并确保这些JavaScript文件已正确地排队和调用。

接口

函数定义如下:

wp_enqueue_script( $handle, $src = false, $deps = array(), $ver = false, $in_footer = false );
参数
  • $handle(必填):自定义脚本别名的唯一ID,用于区分添加的脚本;
  • $src(可选):含有脚本源的Web地址,当需要添加外部库或脚本到WordPress主题中时必须设置参数;
  • $deps(可选):显式地依赖的其他脚本(所依赖的脚本必须先启动);
  • $ver(可选):版本号,用于浏览器缓存(默认为false,使脚本每次请求都是最新版本);
  • $in_footer(可选):布尔值,标示该脚本需要在WordPress页面的底部加载(默认情况下,所有脚本都会在头部加载)。
实例
function mytheme_scripts() {
    wp_enqueue_script( 'custom-script', get_template_directory_uri() . '/js/custom-script.js', array( 'jquery' ), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );

以上代码片段中,我们定义了一个函数mytheme_scripts,用来引入位于js/子目录(相对于主题根目录)内的自定义脚本custom-script.js$handle参数 ”custom-script“ 用于脚本的别名,$src参数为脚本文件的URI,$deps参数依赖于jQuery库。除此之外,我们还设置了脚本版本号为1.0,并强制在页面底部输出。

总结

在 WordPress 主题开发过程中,wp_enqueue_script()函数的使用是非常重要的,特别是当页面须依赖多个脚本文件时,这个函数的使用更为明显。同时建议在主题中引用最新版本的jQuery库以保证兼容性。