在WordPress中,wp_enqueue_script()
和 wp_enqueue_style()
是两个非常重要的函数,它们用于将JavaScript脚本和CSS样式表注册并添加到页面上。以下是使用这两个函数的基本步骤:
1. 使用 wp_enqueue_script()
添加JavaScript脚本
function my_theme_enqueue_scripts() {
// 注册一个脚本,并指定其依赖(例如jQuery)
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_localize_script
$translation_array = array(
'ajax_url' => admin_url('admin-ajax.php'), // 传递AJAX URL
'some_var' => 'Some Value', // 传递其他变量
);
wp_localize_script('my-custom-script', 'my_ajax_obj', $translation_array);
}
// 在wp_enqueue_scripts钩子中添加我们的函数
add_action('wp_enqueue_scripts', 'my_theme_enqueue_scripts');
2. 使用 wp_enqueue_style()
添加CSS样式表
function my_theme_enqueue_styles() {
// 注册一个样式表
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');
注意事项:
- 注册与添加:首先使用
wp_register_script()
或wp_register_style()
注册脚本或样式表,然后使用wp_enqueue_script()
或wp_enqueue_style()
将它们添加到页面上。 - 依赖关系:在注册脚本时,可以指定依赖关系(例如,许多JavaScript插件依赖于jQuery)。WordPress会确保依赖关系按正确的顺序加载。
- 版本号:指定脚本的版本号可以确保当脚本更新时,浏览器会加载最新的版本,而不是缓存的老版本。
- 在footer中加载:
wp_enqueue_script()
的最后一个参数设置为true
时,脚本会在页面的底部加载,这通常对性能更有利。 - 本地化脚本:使用
wp_localize_script()
可以将PHP变量传递给JavaScript。 - 钩子:确保将你的函数添加到
wp_enqueue_scripts
钩子上,这是WordPress在输出页面前加载脚本和样式表的地方。
使用这些函数可以有效地管理你的WordPress主题或插件中的脚本和样式表,并确保它们在正确的位置以正确的顺序加载。