在WordPress中,wp_enqueue_script()
和 wp_enqueue_style()
是用于注册和排队(enqueue)JavaScript 脚本和 CSS 样式的两个重要函数。以下是使用这些函数的正确步骤:
1. 在主题的 functions.php
文件中添加代码
首先,你需要在你的主题的 functions.php
文件中添加代码来注册和排队脚本和样式。
2. 使用 wp_enqueue_script()
函数
以下是使用 wp_enqueue_script()
的步骤:
// 注册一个JavaScript脚本
function my_theme_enqueue_scripts() {
// 注册脚本,可以设置一个handle(句柄),脚本路径,依赖,版本和是否在页脚加载
wp_register_script('my-custom-script', get_template_directory_uri() . '/js/my-script.js', array('jquery'), '1.0.0', true);
// 排队脚本,确保它会在页面上加载
wp_enqueue_script('my-custom-script');
}
// 在 'wp_enqueue_scripts' 动作上添加函数
add_action('wp_enqueue_scripts', 'my_theme_enqueue_scripts');
3. 使用 wp_enqueue_style()
函数
以下是使用 wp_enqueue_style()
的步骤:
// 注册一个CSS样式
function my_theme_enqueue_styles() {
// 注册样式,可以设置一个handle(句柄),样式路径,依赖,版本和媒体类型
wp_register_style('my-custom-style', get_template_directory_uri() . '/css/my-style.css', array(), '1.0.0', 'all');
// 排队样式,确保它会在页面上加载
wp_enqueue_style('my-custom-style');
}
// 在 'wp_enqueue_scripts' 动作上添加函数
add_action('wp_enqueue_scripts', 'my_theme_enqueue_styles');
注意事项:
- Handle(句柄): 每个脚本和样式都应该有一个唯一的句柄名称。
- 依赖: 如果你的脚本依赖于其他脚本(例如jQuery),你应该在数组中列出它们。
- 版本: 当脚本或样式更新时,你应该增加版本号以强制浏览器获取最新版本。
- 在页脚加载: 对于JavaScript,通常建议在页脚加载以提高页面加载速度,所以最后一个参数设置为
true
。 - 媒体类型: 对于样式表,你可以指定它们应该应用于哪种媒体类型(例如
'all'
,'screen'
,'print'
)。
不要直接在主题中链接脚本和样式
使用 wp_enqueue_script()
和 wp_enqueue_style()
的好处之一是,WordPress 可以更有效地管理脚本和样式,例如合并和最小化文件,以及确保依赖关系得到正确处理。因此,你应该避免在主题的HTML中直接使用 <script>
或 <link>
标签来链接脚本和样式。始终使用这些函数来排队它们。