在WordPress中,wp_enqueue_script()
和 wp_enqueue_style()
是两个非常重要的函数,它们用于将JavaScript脚本和CSS样式表注册并加入到页面的头部或底部。以下是如何使用这两个函数的步骤和示例:
wp_enqueue_script()
这个函数用于将JavaScript脚本文件注册并加入到页面的底部。
-
注册脚本:
首先,你需要使用wp_register_script()
函数来注册脚本,但如果你直接使用wp_enqueue_script()
,WordPress会自动为你注册。 -
加入队列:
使用wp_enqueue_script()
将脚本加入到WordPress的队列中,这样它就会在页面加载时被输出。
示例代码:
function my_theme_enqueue_scripts() {
// 注册一个脚本,并设置其依赖性和版本(可选)
wp_enqueue_script('my-theme-script', get_template_directory_uri() . '/js/myscript.js', array('jquery'), '1.0.0', true);
// 如果脚本需要一些局部变量,可以使用wp_localize_script()
$translation_array = array(
'some_string' => __('Some string to translate', 'my-theme'),
'a_value' => '10'
);
wp_localize_script('my-theme-script', 'my_localized_script', $translation_array);
}
add_action('wp_enqueue_scripts', 'my_theme_enqueue_scripts');
在上面的代码中,'my-theme-script'
是脚本的唯一标识符,get_template_directory_uri() . '/js/myscript.js'
是脚本的URL,array('jquery')
表示这个脚本依赖于jQuery,'1.0.0'
是脚本的版本号,true
表示脚本应该被放在页面的底部。
wp_enqueue_style()
这个函数用于将CSS样式表注册并加入到页面的头部。
-
注册样式:
同样,你可以使用wp_register_style()
来注册样式,但通常直接使用wp_enqueue_style()
。 -
加入队列:
使用wp_enqueue_style()
将样式表加入到WordPress的队列中。
示例代码:
function my_theme_enqueue_styles() {
// 注册并加入一个样式表
wp_enqueue_style('my-theme-style', get_template_directory_uri() . '/css/mystyle.css', array(), '1.0.0', 'all');
// 如果有额外的样式表需要加入,可以继续使用wp_enqueue_style()
wp_enqueue_style('my-theme-fontawesome', 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/all.min.css', array(), '5.15.3', 'all');
}
add_action('wp_enqueue_scripts', 'my_theme_enqueue_styles');
在上面的代码中,'my-theme-style'
是样式表的唯一标识符,get_template_directory_uri() . '/css/mystyle.css'
是样式表的URL,array()
表示没有依赖的样式表,'1.0.0'
是样式表的版本号,'all'
表示样式适用于所有媒体类型。
确保将这些函数钩子添加到 wp_enqueue_scripts
动作中,这样它们就会在WordPress渲染页面时被调用。