当我们在WordPress主题定制开发过程中,经常需要引入一些JS文件,一般的处理方式是在主题文件的header.php或者footer.php文件中引入JS。其实,WordPress有一个最佳引入JS文件的函数,那就是wp_enqueue_script。通过该函数可以安全地将javascript代码加入到WordPress创建的页面中,不仅可以最大限度地保证兼容性,还可以提高wordpress的性能和效率。
函数代码:
<?php wp_enqueue_script( $handle,$src,$deps,$ver,$in_footer ); ?>参数说明:
$handle – 调用的脚本名称,用于区别其它js,因此不能和其它js文件命名相同。$src – js文件的路径(即url),不要直接使用域名url,要使用路径函数,如parent theme使用get_template_directory_uri,child theme使用get_stylesheet_directory_uri。(WP模板路径相关的函数中,通常带有template的是指parent theme,带有stylesheet的指向child theme)
$deps – 依赖关系,加载的js文件所依存的其它js的标识字串数组(array:string),即需要在本代码之前加载的代码的名称(如js脚本依赖jquery库,那么这里要用数组的形式写上jquery),非必需。
$ver – 加载js文件的版本号,作为查询字串附加在路径的末尾,作用是确保正确的版本信息传递给了客户端,以免受到缓存的影响(如js脚本发生变化时,通过更改版本号可以强制客户浏览器更新缓存),默认为false,调用当前wordpress程序的版本号,如果不想显示,则设置为NULL(不推荐)。
$in_footer – boolean类型,设置js文件调用代码是否放置在html底部,设置为ture则放在底部,设置为false则放置在head部分。提示需要模板正确放置wp_footer()函数。
使用方法:
通过wp_enqueue_script函数加载js文件时,应该将它分配给一个钩子,如只在前台调用,使用钩子wp_enqueue_script;只在后台调用,使用admin_enqueue_scripts。使用举例:
只在前台调用<?php
function my_theme_scripts() {
wp_enqueue_script( 'myjs',get_template_directory_uri() . '/js/my.js',array(),'1.0.0',true );
}
add_action( 'wp_enqueue_scripts','my_theme_scripts' );
?>只在后台调用
<?php
function my_theme_scripts() {
wp_enqueue_script( 'myjs',true );
}
add_action( 'admin_enqueue_scripts','my_theme_scripts' );
?>
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。